backend-junit-run-2026-11-03.md 10.0 KB

后端 JUnit 全量执行记录(2026-11-03)

  • 触发:用户指示「mvn -o -DskipITs test 可以分派给 iwintrue 智能体」
  • 派发通道:opencode.iwintrue.com DNS 不解析(NXDOMAIN),派发不可达 → 详见 dispatch-junit-iwintrue.md
  • 兜底执行:本机离线(IntelliJ 自带 Maven 3.9.9 + JDK 1.8.0_25 + 已填充 .m2),全程 -o 不联网
  • 结论:后端测试可执行,且大量用例真实失败——不是「环境跑不起来」,而是「跑起来后发现 147 例红」

一、最终统计

指标 数值
测试类总数 197(含 1 个无 @Test 的 TestRoles)→ 实际可执行 196
执行类数 196(含补跑 2 个 Gate 测试)
用例执行数 1456
通过 1305
失败 Failures 70
错误 Errors 77
跳过 Skipped 4(含 3 个整类 @Disabled)
通过率 89.88%(1305 / 1452 有效执行)
未执行 18 例(AIChatControllerGateTest 编译不通过)+ 17 例(3 个类整体 @Disabled)

产物:cfc-backend/target/surefire-reports/*.xml|txt(196 份报告) 日志:docs/tdd/test/mvn-test-2026-11-03-0855.log(首轮编译失败)、docs/tdd/test/mvn-surefire-2026-11-03.log(全量跑测)

二、失败分布(按现象聚类)

聚类 数量 代表类
断言值不符 expected: <N> but was: <N> 27 ArticleControllerTest
NullPointerException 26 ArticleControllerTest:90
IllegalStateException: Failed to load ApplicationContext 8 AdminFamilyOverviewControllerTest 等 8 个集成/服务类
Mockito WantedButNotInvoked 8 CfCommissionServiceSettleTest:419
Mockito InvalidUseOfMatchersException 6 ProductControllerTest:289
Mockito MockitoException 5 ArticleControllerTest
断言 expected: not <null> 5 ArticleControllerTest
断言 expected: <N> but was: <null> 4 GuideFamilyTaskControllerTest
断言 expected: <true> but was: <false> 4 PaymentControllerTest
NoSuchFieldException 3 TaskProgressUpdateTest:64
文案不符(仅已驳回… vs 仅已驳回或已撤回…) 3 ArticleWorkflowTest
Mockito ArgumentsAreDifferent 3 ProductOrderServiceUpdateExprTest

失败最集中的类:ArticleControllerTest(4F+5E)、AuthControllerTest(4F)、GuideOrderControllerTest(6F+2E)、ProductOrderControllerTest(0F+6E)、GuideRolePermissionTest(4F+1E)、PaymentControllerTest(4F)。

三、五要素问题清单

P0-1 · Map.of 用法导致 196 个测试文件全量编译失败

① 问题描述:mvn -o -DskipITs test 在 compiler:testCompile 阶段报 1 error 直接失败,1466 例一例未执行。 ② 测试 bug 点:cfc-backend/src/test/java/com/etotem/cfc/controller/ai/AIChatControllerGateTest.java:53 —— new LinkedHashMap<>(Map.of("answer","OK","conversationId",""));Map.of 为 Java 9+ API,而 pom.xml:23/214/215 声明 java.version=1.8。 ③ 最优修改方案:改为 Java 8 写法 Map<String,Object> m = new HashMap<>(); m.put("answer","OK"); m.put("conversationId","");(或 Collections.unmodifiableMap)。 ④ 修改目的:解除全量编译阻塞,让 1466 例回到可执行状态。 ⑤ 闭环:mvn -o -DskipITs test 不再在 testCompile 失败;通过标准 = testCompile 0 error,且该文件 18 例进入执行。

P0-2 · pom.xml 默认 skipTests=true,mvn test 静默全跳过

① 问题描述:绕开 P0-1 后执行 surefire:test,输出 [INFO] Tests are skipped. + BUILD SUCCESS(6.8s,0 例执行)。 ② 测试 bug 点:cfc-backend/pom.xml:28 <skipTests>true</skipTests>,:232 <skipTests>${skipTests}</skipTests>。 ③ 最优修改方案:将默认值改为 false,需要跳过时显式 -DskipTests=true;CI 中固定 -DskipTests=false。 ④ 修改目的:消除「绿色但零覆盖」的假绿信号,让本地/流水线的 mvn test 具备真实门禁意义。 ⑤ 闭环:mvn test 默认执行用例;通过标准 = 输出中出现 Tests run: ≥1456 且非 Tests are skipped。

P0-3 · target/classes 陈旧且 mvn compile 误报「无需编译」

① 问题描述:mvn compile 输出 Nothing to compile - all classes are up to date,但 target/classes 缺 com/etotem/cfc/dto/AiGateResult.class(源码存在),导致 ButlerControllerGateTest、MembershipServiceAiGateTest 编译报「找不到符号」。 ② 测试 bug 点:构建状态 —— cfc-backend/target/classes 与 src/main/java 不一致(非源码缺陷);影响 ButlerControllerGateTest(9)、MembershipServiceAiGateTest(12) 共 21 例。 ③ 最优修改方案:mvn -o -B clean compile 重建;CI 每次 clean 起步,禁止复用陈旧 target。 ④ 修改目的:保证「编译产物 = 当前源码」,避免测试假失败与污染性排查。 ⑤ 闭环:重建后该 21 例编译通过并全绿(本次实测 21/21 通过);通过标准 = mvn -o clean test 一次成型。

P1-4 · ArticleControllerTest 26 处 NPE,断言基于 null 赋值

① 问题描述:ArticleControllerTest 11 例中 4 失败 5 错误,NPE 集中在 list(body,null,null) 返回 null 后直接 .getCode()。 ② 测试 bug 点:src/test/java/com/etotem/cfc/integration/controller/ArticleControllerTest.java:90(assertEquals(200, result.getCode()),result 为 null);同文件 :226。 ③ 最优修改方案:先 assertNotNull(result) 再断言;并为 articleService 的 list 打桩返回 Page,明确 service 返回值契约。 ④ 修改目的:把「实现返回 null」的真问题与「测试解引用 null」的写法问题分离,避免 26 条 NPE 淹没真实缺陷。 ⑤ 闭环:该文件 NPE 归零、失败项能给出明确断言差异;通过标准 = ArticleControllerTest 0 error。

P1-5 · ProductControllerTest 混用裸值与 matcher

① 问题描述:6 例 InvalidUseOfMatchersException,Mockito 拒绝「部分参数用 matcher、部分用裸值」。 ② 测试 bug 点:src/test/java/com/etotem/cfc/integration/controller/ProductControllerTest.java:289 —— when(productService.shelve(1L, isNull(), "publish"))。 ③ 最优修改方案:全部参数改 matcher(eq(1L), isNull(), eq("publish"))。 ④ 修改目的:恢复 Mockito 桩可用性,让上架流程断言真正生效。 ⑤ 闭环:该类 0 error;通过标准 = ProductControllerTest 全绿。

P1-6 · TaskProgressUpdateTest 反射注入已不存在的字段

① 问题描述:3 例 NoSuchFieldException: platformPointsService。 ② 测试 bug 点:src/test/java/com/etotem/cfc/unit/TaskProgressUpdateTest.java:64(inject() 内 TaskService.class.getDeclaredField(field)),调用点 :59;TaskService 中已无该字段。 ③ 最优修改方案:删除该注入或用例;改为按现有依赖(pointsLogMapper/energyService)构造场景。 ④ 修改目的:消除测试与被删字段的强耦合,避免实现重构后测试整类失效。 ⑤ 闭环:该类 0 error;通过标准 = TaskProgressUpdateTest 全绿。

P2-7 · 8 个类 Failed to load ApplicationContext

① 问题描述:8 个集成/服务测试类 Spring 上下文加载失败(AdminFamilyOverviewControllerTest、DailyOverviewServiceTest、DimensionEnergySyncServiceTest、DimensionScoreServiceImplTest、FamilyAdminOverviewServiceTest、GuideApplicationServiceTest、GuidePackageServiceTest、UserServiceFamilyNameLinkTest)。 ② 测试 bug 点:上述 8 个类的 @SpringBootTest 装配(缺 profile/数据源/表结构依赖),非单点代码行。 ③ 最优修改方案:改用 @SpringBootTest(webEnvironment=NONE, properties=...) + 测试 profile(H2/独立 schema),或降级为 @WebMvcTest 切片测试。 ④ 修改目的:让集成测试不依赖开发者本机 DB 状态,可在任意环境复现。 ⑤ 闭环:8 个类上下文加载成功;通过标准 = 0 例 Failed to load ApplicationContext。

P2-8 · 3 个测试类整体 @Disabled,17 例静默不执行

① 问题描述:DataMigrationServiceTest(11)、TaskServiceMinigameTest(5)、TeacherLoginTest(4) 各只报 Tests run:1, Skipped:1,实际用例全部未跑。 ② 测试 bug 点:三类的类级 @Disabled 注解(src/test/java/com/etotem/cfc/service/)。 ③ 最优修改方案:逐类标注禁用原因与解除条件(Issue 号 + 负责人 + 期限),或改造成可运行的最小用例。 ④ 修改目的:避免「禁用即遗忘」造成长期覆盖空洞(含数据迁移、迷你游戏、教师登录三条关键路径)。 ⑤ 闭环:三类恢复执行或明确下线;通过标准 = @Disabled 数量在台账中可追溯且 ≤ 0 无主用例。

四、复现命令(不改源码亦可复现)

cd cfc-backend
# 1) 主编译(必须先做,规避陈旧 target)
mvn -o -B clean compile
# 2) 导出测试 classpath
mvn -o -B org.apache.maven.plugins:maven-dependency-plugin:3.1.1:build-classpath \
    -DincludeScope=test -Dmdep.outputFile=target/cp.txt
# 3) 编译测试(排除 Map.of 不合规文件)
find src/test/java -name "*.java" -not -name "AIChatControllerGateTest.java" > target/testfiles.txt
javac -encoding UTF-8 -source 1.8 -target 1.8 -cp "target/classes;$(cat target/cp.txt)" \
      -d target/test-classes @target/testfiles.txt
# 4) 直连 surefire 跑测(pom 默认 skipTests=true,必须显式关掉)
mvn -o -B surefire:test -DskipTests=false -Dmaven.test.failure.ignore=true

五、结论

  • 后端测试可执行:196 类 / 1456 例,通过 1305(89.88%),失败 70 + 错误 77。
  • 修复 P0-1/P0-2/P0-3 后,mvn -o -DskipITs test 即可一条命令跑全量,无需本记录中的绕行手段。
  • 本次排除:AIChatControllerGateTest 18 例(编译阻塞);@Disabled 17 例。未实测部分不得记作通过。
  • iwintrue 通道仍未打通:需 DNS 恢复 + 补 .workbuddy/dispatch.py 才能真正派发(工单见 dispatch-junit-iwintrue.md)。