cfc/docs/tdd/test/blockers.md

测试 → 研发 阻塞台账（正式通道）

纪律：本台账条目经测试负责人 --mark-blocked（或补登记）产生，push 到远端才算送达研发； 解除时由测试用 --clear-blocked 置「已解除」。缺陷详情载体见 test_blockers.md 与各轮巡检报告。

编号	关联键/对象	类型	描述	经办	登记时间	状态
B-1	cfc-backend surefire 13 红	研发	后端套件产物（11-02 08:31–08:39）148 用例中 8 fail + 5 error 长期未修；1315/1491 @Test 无执行记录。需研发修复红例并补跑全量	测试（巡检补登记）	2026-11-03 10:58	待处理
B-2	R5 · admin-auth/login	研发	POST /api/admin-auth/login 未授权/空 body 返回 500（应为 401/403，异常信息泄露），安全语义缺陷。详情见 test_blockers.md R5	测试（巡检补登记）	2026-11-03 10:58	待处理
B-3	R6 · 报告上传	研发	报告上传未做 MIME/扩展名/内容校验，非 PDF 未被拒（非 4xx），恶意文件上传风险。详情见 test_blockers.md R6	测试（巡检补登记）	2026-11-03 10:58	待处理
B-4	F1/F2 · butler envelope / commission 400	研发	§7.1 七条真实 unexpected 缺陷中 F1（butler envelope）、F2（commission 400）复跑确认仍未修复	测试（巡检补登记）	2026-11-03 10:58	待处理
B-5	接口冒烟 REAL_ERR 分型	研发	interface_classify_failures.py 分型出 49 条 REAL_ERR（基于 11-01 轮次）未派单未修复；冒烟通过率停 45%，需研发按分型认领真实错误端点	测试（巡检补登记）	2026-11-03 10:58	待处理
B-6	health.report.createReport	研发	TDD 状态机 RED 停滞（自 11-02 01:06 起）：契约级单测已落地并离线实跑 5 例全绿（HealthReportControllerCreateReportTest，commit 81d8883f7 已推 origin/cfclub），实现已在库；缺研发 --mark-yellow 登记，状态机无法推进至 GREEN。更新：2026-11-04 15:20 测试侧复核实跑	测试（巡检更新）	2026-11-03 10:58	待处理
B-7	dan.assessment.getActiveMaterial	研发	TDD 状态机 RED 停滞（自 11-02 01:06 起）：契约级单测已落地并离线实跑 3 例全绿（DanAssessmentControllerGetActiveMaterialTest，commit faf3ca174 已推 origin/cfclub），实现已在库；缺研发 --mark-yellow 登记，状态机无法推进至 GREEN。更新：2026-11-04 15:20 测试侧复核实跑	测试（巡检更新）	2026-11-03 10:58	待处理
B-8	CfBalanceControllerTest（P0 编译回归）	研发	commit dfc78e9d3（2026-11-03 23:27）给 CfBalanceController.balance/logs 新增 currentMemberId 参数，但 CfBalanceControllerTest.java（76230e2f4，2026-10-25）未同步 → 7 处编译错误（行 95/113/121/140 调 balance、169/189/202 调 logs），整模块 testCompile 失败，1474 @Test 零执行。需研发补改测试 7 处调用或回退签名	测试（巡检补登记）	2026-11-04 03:49	已解除 → 44b2f0d42（2026-11-05 00:31）重写控制器移除 currentMemberId 再次触发同源编译回归，详见 B-10（待处理）
B-9	guide.trainingPlan.getPlanDetail（鉴权缺口观察）	研发	POST /api/guide/training-plans/detail handler 在控制器层不读取 @RequestAttribute("role")，亦未列入 JwtInterceptor LOGIN_REQUIRED_PATHS，「规划师角色约束」名义成立但任何已认证角色（乃至匿名 userId=-1）均可到达 handler，属潜在越权缺口（同文件 getPlanList 同类观察，TR-1 第 6 点要求测试侧记录）。契约测试已落地（TrainingPlanControllerGetPlanDetailTest，8 例全绿），本条仅作缺陷观察回写，不阻断 RED→YELLOW→GREEN 推进	测试负责人（应 TR-1 登记）	2026-11-04 10:10	待处理
B-10	CfBalanceControllerTest（P0 编译回归·复发）	研发	commit 44b2f0d42（2026-11-05 00:31:53，「chore(sync): 工作区遗留未提交 WIP 收尾同步」）重写 CfBalanceController.balance 为 balance(@RequestAttribute("userId") Long userId)、logs 为 logs(userId, page, size)，删除 currentMemberId 参数及 stats/familySummary 方法；但测试 CfBalanceControllerTest（仍停在 c9f9ec948，曾为修复上轮 P0 给测试加上 currentMemberId 实参）未同步 → 仍调 balance(7L, null) / logs(7L, null, 1, 20)，实参个数不符 → testCompile 失败，1474 @Test 零执行。需研发改测试 7 处调用去掉 currentMemberId 实参（或回退 44b2f0d42 改写）。本轮（01:05）复跑复现，日志 /d/cfc/.tdd/backend-run-20261105-0105.log。升级（01:36 复跑确认）：测试文件已被 44b2f0d42 迁移至 cfc-backend/src/test/java/com/etotem/cfc/unit/CfBalanceControllerTest.java，仍以旧签名调用 → 7 处编译错误（行 95/113/121/140 调 balance(7L,null)、169/189/202 调 logs(7L,null,1,20)，控制器现为 balance(userId) 单参 / logs(userId,page,size) 三参）→ mvn -o -B -f cfc-backend/pom.xml -DskipTests=false -Dtest='HealthReportControllerCreateReportTest,DanAssessmentControllerGetActiveMaterialTest,TrainingPlanControllerGetPlanDetailTest' test @ testCompile BUILD FAILURE；全模块 1474 @Test + 16 契约测试（历史 8 轮全绿）全部零执行，4 个 YELLOW 键（createReport/getActiveMaterial/getTree/mapLegacyCode）复验收口亦被连带阻断。优先级 P0（阻断全模块测试验证）。建议研发：改测试 7 处调用（balance(7L) / logs(7L,1,20)）或回退 44b2f0d42	测试（01:36 复跑确认补登记）	2026-11-05 01:36	已解除（03:30 复验确认）：研发负责人1 正式修复 37f29a5df（2026-11-05 02:30，移除 7 处多余 null 实参与 balance(userId)/logs(userId,page,size) 对齐）已推 origin/cfclub 且 merge-base --is-ancestor 核验通过；测试侧 03:30 在远端基线复跑：testCompile 205 源 0 错、16 契约测试（createReport 5 + getActiveMaterial 3 + getPlanDetail 8）16/16 全绿、CfBalanceControllerTest 8/8 绿（含在全量 204 类/1528 例 91.88% 基线，02:50 批次全量实跑）。复验通道恢复，2 个 YELLOW 键（getActiveMaterial/createReport）测试复验通过
B-11	/api/cf 三端点删除（待确认意图）	研发	44b2f0d42（11-05 00:31，chore(sync) 工作区 WIP 收尾）删除 /api/cf/stats、/api/cf/family-summary、/api/cf/promotion-earnings 及前端 3 个封装（-210 行）。全套 1528 例零转红，即删除行为无任何用例可证伪。该提交标题为"遗留 WIP 收尾同步"，具备误覆盖特征。需研发确认：有意精简 / 误覆盖 → 前者补 API_REFERENCE.md 下线记录，后者 revert 并补 3 端点用例	测试（36 轮巡检登记）	2026-11-05 02:48	待处理
B-12	3 类 20 个 @Test 长期 @Disabled	研发/测试	DataMigrationServiceTest(11，依赖 sfms 数据源)、TaskServiceMinigameTest(5，依赖硬编码 userId=1L)、TeacherLoginTest(4，依赖硬编码手机号，测试间数据污染) 均类级 @Disabled；台账 @Test 1545 与实际执行 1528 差 17 例。根因统一为测试数据夹具缺失。需建 seed 脚本/@Sql 夹具后解禁。口径精确化（37 轮）：注解 1545 − 20（3 类 @Disabled 内注解）+ 3（surefire 为每个禁用类仍记 1 条 skipped 占位）= 1528，误差 0；已逐类排除「参数化展开」假设（全仓参数化类 注解数=执行数）。	测试（36 轮登记/37 轮精确化）	2026-11-05 02:48	待处理
B-13	3 个 @SpringBootTest 类硬编码 127.0.0.1:3306（环境红根因）	研发/环境	AdminFamilyOverviewControllerTest.java:21-22、service/FamilyAdminOverviewServiceTest、service/UserServiceFamilyNameLinkTest 三处 @SpringBootTest(properties={"spring.datasource.url=jdbc:mysql://127.0.0.1:3306/zxyj…"}) 硬编码本机 MySQL；本机无 MySQL → Connection refused → Failed to load ApplicationContext，8 例每轮必红（37 轮实测异常链：BeanCreationException → primaryDataSource → HikariPool$PoolInitializationException → CommunicationsException → ConnectException）。全仓 grep -rl 127.0.0.1:3306 src/test 命中恰好这 3 类。非池压力（37 轮 Too many connections 出现 0 次）。建议：改 @ActiveProfiles("test") + src/test/resources/application-test.yml 统一指向 192.168.16.251 测试库（池上限 4）。	测试（37 轮巡检登记）	2026-11-05 05:30	待处理
B-14	测试窗口内并发提交（基线漂移）	研发/流程	38 轮全量跑测窗口（06:16→07:15，58:41）内 HEAD 由 345cf745e 前移至 f1b0e3ed5，落入 8660d7dbe（SC-G-06 越权拦截：JwtInterceptor+3 测试类）与 0dce400d2/f1b0e3ed5（switchRole：FamilyMembersController/FamilyMemberService+FamilyUserSwitchRoleTest）；4 个测试文件 mtime 07:14:57–07:15:12 晚于 testCompile（Compiling 205 source files）→ 聚合首扫即 源类 208 / 报告 204 / 沉默 4。若不补跑将把 41 例新增用例漏记、并把新特性回归风险误报为「零变更」。已处置：定向补跑 5 类 46/46 绿（testCompile 209 源 0 错）。遗留：其余 199 类未在 f1b0e3ed5 上重验。建议跑测改 git worktree 固定 SHA 或 CI checkout SHA，报告头部固化 rev-parse HEAD	测试（38 轮登记）	2026-11-05 07:25	部分处置（补跑已完成，全量复验待下轮）
B-15	度量脚本丢失且从未入库	测试/度量	discover_tests.py / test_inventory.py 全仓 find 无命中，git log --all 为空 → 从未提交，属本地未跟踪脚本已被清理；历史台账「覆盖 365 / 跨源用例 2731 / @Test 1545」不可复现，跨轮对比失去基准。38 轮改用内联统计（357 控制器 / 1933 @PostMapping / 8 @GetMapping / 204 测试文件 / 1546 @Test）。建议脚本纳入 docs/tdd/tools/ 并提交，报告注明脚本版本	测试（38 轮登记）	2026-11-05 07:25	待处理
B-16	根级 integration 套件缺凭据夹具（12 例恒红）	测试	9082 已在线后套件不再 fetch failed，暴露真实根因：tests/integration/plan-chain.spec.js:21-22 依赖 ADMIN_PHONE/ADMIN_PASSWORD（当前为空）→ [0] 前置环境检查 收到空串、[1] 登录 返回 code=500 msg=用户不存在；mini-games-api.spec.js 10 例 Expected 200 / Received 401（无 token）。判为测试侧配置缺口，非生产缺陷。建议新增 tests/.env.test + seed 脚本，globalSetup 内自动登录取 token，CI 注入 API_BASE_URL=http://127.0.0.1:9082	测试（38 轮登记）	2026-11-05 07:25	待处理
B-17	.tdd/state.json 与 08:12 轮报告脱节（新增 2 RED 键未落账）	研发/流程	08:12 轮报告（automation-run-2026-11-05-0812.md）与提交 69f8820d8 说明称新建 task.parent.createTask / task.parent.review 两个 RED 键并落契约测试（39 轮独立实测 7 绿 + 17+15=32 绿，与报告吻合）；但本地 .tdd/state.json 仍只有 3 键（health.report.createReport / dan.assessment.getActiveMaterial / guide.trainingPlan.getPlanDetail），updated_at 仍为 2026-11-04 10:14。报告说的 ≠ 状态机记的，看板无法反映真实进展。需走 CLI 补登记（--add-task + --mark-red --commit <sha>），禁止手改 state.json	测试（39 轮巡检登记）	2026-11-05 09:40	待处理
B-18	A 类测试漂移 54 例集中爆发（Mockito 误用 + 断言基线过期）	研发/测试	39 轮全量实测非环境红 112 例/34 类，其中 A 类 54 例/17 类可纯测试侧修复：doNothing() 用于非 void 方法（ArticleControllerTest/PlannerBindInviteFlowTest/DailyCheckinStreakFlowTest）、matcher 混用（ProductControllerTest 3E InvalidUseOfMatchers、ProductOrderServiceFulfillmentMultiModeTest 6E）、桩名过期（ProductOrderControllerTest 6E 打 confirm/实现 confirmReceive）、反射注入已删字段（TaskProgressUpdateTest 3E NoSuchFieldException: platformPointsService）、断言基线漂移（WishControllerTest 文案 childId→memberId；StatsControllerTest/MindFortuneControllerTest 500 vs 5001；HealthDimensionControllerTest 期望 500 实得 200）。批量修完 54 例后 G1 由 92.41% → ≈95.7%，G2 由 112 → 58，是当前性价比最高的一步。精确化（22:13 轮实测，维度合并后首验 28 例 26 绿/2 红）：HealthDimensionControllerTest.overview_missingMemberId:58 / history_missingMemberId:217 期望 result.getCode()==500 实得 200——根因＝用例调用 controller.overview(params, 1L, 1L) / history(params, 1L, 1L) 误传 currentMemberId=1L，实现 ParamUtils.getLong(params.get("memberId"), currentMemberId) 触发双角色「家长视角 currentMemberId 兜底」（设计行为）→ memberId=1L 非空走正常路径 200。测试装置口径错误，非生产缺陷；修复：第 3 参传 null（或断言兜底 200）	测试（39 轮登记，22:13 轮精确化）	2026-11-05 09:40	待处理
B-19	cfc-langgraph pytest 长期「未实测」结论已过期，首次实测 19 红	测试/研发	41 轮（11-05 15:19）探活发现 cfc-langgraph/.venv/Scripts/python.exe = Python 3.12.7，pytest 9.2.0 / fastapi / httpx / langgraph 全部可 import → 此前 #28–#40 多轮报告的「无 .venv / 缺 httpx → pytest 47 例未实测」结论过期（度量失真，同 N-1 类）。首次实跑 pytest tests --ignore=tests/qna：43 例 24 绿 / 19 红（55.81%）。19 红分层：C 环境 14 例（401 Authentication Fails, Your api key: ****ocal is invalid → analyze 2 + auto_tag 5 + chat 1 + intent 4；另 report_parse 2 例因用例写死容器路径 /app/cfc/docs/参考资料/*.pdf 在本机 400）；A 测试漂移 5 例（test_graph 2：GenerateRequest.respondent_name Field required 而用例仍发 member_name；test_memory 3：MemoryManager.__init__() missing 'embeddings'）。另 tests/qna/test_graph.py 收集期 ModuleNotFoundError: No module named 'src.qna' → 整模块 0 例可执行（死资产）。建议：①注入测试 LLM 凭据或对 LLM client 全 mock；②test_report_parse 路径改相对仓库路径；③删/重写 tests/qna/test_graph.py；④pytest 纳入 CI	测试（41 轮巡检登记）	2026-11-05 16:20	待处理
B-20	Playwright 规模扩张至 96 spec 而长期未实测	测试/环境	#40 记录 69 spec / 402 test()，#41 复核为 96 个 spec 文件（+27），但唯一一次实测是 11-05 12:14 execute 档（用户显式授权联网）的 API 级 83 例（66 绿 / 6 红 / 3 跳过 / 8 串行阻塞，91.67%）；UI 级因 cfc.iwintrue.com 无前端页面（/ 404）不可跑。此后各轮均记「未授权联网 → 未实测」。风险：spec 持续增长而信号为零，用例腐化不可见（如 12:14 已发现 2 条路径/断言过期）。建议：①本地 9082 在听时改用 playwright.config.api.js（无 globalSetup，不 reset 共享库）纳入每轮；②默认配置的 globalSetup 会 reset-db.sh 重置共享测试库，禁止在共享环境直接跑；③UI 级待补独立前置环境	测试（41 轮登记）	2026-11-05 16:20	待处理
B-21	SC-P-11 契约回归（YELLOW 键首次转红）	研发/测试	42 轮全量实测：TaskControllerReviewTest 由连续 7 轮 17/17 全绿降为 15/17（pendingReview_parent_success_returnsList:176 与 pendingReview_directCall_uniformResultShape:316 均 NPE）。根因＝SC-X-22 合入 f14e46f84 在 TaskController.java:197/205 新增 rewardRuleService.attachTaskListEstimate(...)，而该测试用 new TaskController() + 手工注入（:80-84）未补 RewardRuleService → 字段 null。性质：A 类（测试夹具未跟进生产新增依赖），生产侧 resolveMemberIdByUser:157/attachTaskListEstimate:193 均有 null 守卫，非生产缺陷。影响：SC-P-11 契约 32 → 30 绿、G8 由「3 红」扩为「5 红」；证明「契约绿无回归网」——无 CI 时绿是瞬时绿。建议：该类补 @Mock RewardRuleService 并注入，同批 grep -l "new TaskController()" src/test 全量排查	测试（42 轮实测登记）	2026-11-05 18:26	已解除（52 轮测试侧自修，2026-11-06 04:5x）：测试侧在 TaskControllerReviewTest.java 补 @Mock RewardRuleService + ReflectionTestUtils.setField(controller, "rewardRuleService", ...)（+6 行）后，定向复跑 17/17 全绿（BUILD SUCCESS），并对完整 9 类 79 例契约套件复跑：74 绿 / 3 红（P-2 MapContract 口径·与既往一致）/ 0 错——B-21 的 2 个 NPE 错误清零，G8 契约红由 5 降至 3。同批 new TaskController() 手工注入排查仍建议执行（B-22 关联）
B-22	CF 预估挂载的 N+1 读与鉴权清单无守护	研发/测试	①N+1：attachTaskListEstimate（RewardRuleService:193）对列表逐条调 estimate()，已挂 6 处（TaskController:109/197/205/358、GuideFamilyTaskController:271/295），命中 /api/tasks/today、/pending-review、/today-parent、规划师任务历史与待审等高频接口；attachTaskEstimate:186 用 catch (Exception) log.warn 静默吞异常，降级不可见。既有 RewardRuleServiceEstimateTest 仅测单条计算，无「N 条任务 → 查询次数」与「降级仍 200」断言。②鉴权清单：/api/reward/estimate 已正确加入 JwtInterceptor.LOGIN_REQUIRED_PATHS:124-127，但 11 例契约测试为 standalone MockMvc，不经拦截器 → 该清单条目零断言覆盖（历史上 SEC-20261031-01 / SC-G-06 均因鉴权清单漂移返工）。建议：补批量查询次数断言 + 降级断言；补对 LOGIN_REQUIRED_PATHS 全条目的「无 token → 401」参数化契约用例	测试（42 轮巡检登记）	2026-11-05 18:26	待处理
B-23	SC-X-22 契约测试 15 例未入库	测试/流程	RewardEstimateControllerEstimateTest(11) 与 RewardRuleServiceEstimateTest(4) 参与 43 轮全量执行且 15/15 全绿，但 git ls-files 对 cfc-backend/src/test/java/com/etotem/cfc/controller/reward/、.../service/RewardRuleServiceEstimateTest.java 零命中（git status 为 ??，mtime 17:34/17:42）→ 只存在于主工作区。任何 git clean -fd / 工作区重置都会静默丢失（同类事故已发生：B-15 度量脚本丢失）。且违反「完成 = 已提交 + 工作目录干净」铁律，与 O-3 同源（主工作区本轮仍有 126 项未提交/未跟踪）。建议：git add 两路径 → commit + push origin/cfclub → --clean-check 复核；测试/契约文件入库纳入 DoD	测试（43 轮实测登记）	2026-11-05 21:02	待处理
B-24	跑测时延劣化 +18%，结果零漂移（环境时延）	测试/环境	同码复跑对账：XML 单类耗时总和 1649.3s → 1952.2s（+18.4%），Maven 31:36 → 36:49；用例/F/E/S 完全一致（218 类 1664 例 71F 51E 4S）。增量集中 @SpringBootTest 类：GuideOrder +200s、AIChat +120s、Wish +62s、AdminSpecialPrice +53s；期间 Exception during pool initialization 8 次（3 类硬编码 127.0.0.1:3306，B-13 未修），Too many connections 0 次 → 判为外部依赖时延，非代码劣化。风险：长窗口放大 B-14（窗口内并发提交），CI 时长不可估。建议：容器化固定测试库/Redis + 报告中固化「总耗时 / 单类 Top5」基线（±5% 带）	测试（43 轮实测登记）	2026-11-05 21:02	待处理
B-25	新测试类反射注入已删字段（A 类同源反模式）	测试	02:43 轮全量实测：KnowledgeBaseBackfillTest 9 例 2 错，NoSuchFieldException: productDimensionConfigMapper（KnowledgeBaseBackfillTest.java:220）——该字段已在统一维度合并中移除，测试仍用反射注入。与 TaskProgressUpdateTest 3 例（platformPointsService 反射字段同样已删）同源，合计 5 例。性质：A 类（测试装置未跟进生产重构），非生产缺陷。建议：改用服务当前持有的 Mapper 字段或 @InjectMocks，同批 grep -rn 'getDeclaredField' src/test 全量排查	测试（02:43 轮登记）	2026-11-06 03:40	待处理