From 4660e02efc20baa8226293eba929f290a90144bc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=BB=84=E8=87=AA=E8=BE=BE?= <980324341@qq.com> Date: Wed, 7 Oct 2026 20:01:32 +0800 Subject: [PATCH] =?UTF-8?q?test(=E4=BB=BB=E5=8A=A1=E9=AA=A8=E6=9E=B6):=20?= =?UTF-8?q?=E6=8A=8A"=E8=BF=98=E6=AC=A0=E5=A4=9A=E5=B0=91=E9=87=8D?= =?UTF-8?q?=E5=A4=8D"=E9=92=89=E6=88=90=E6=A3=98=E8=BD=AE=EF=BC=8C?= =?UTF-8?q?=E5=B9=B6=E8=AE=A2=E6=AD=A3=203.6k=20=E8=BF=99=E4=B8=AA?= =?UTF-8?q?=E6=95=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 架构评审里给的「任务生命周期约 3.6k 行冗余」经逐行差分不成立:骨架 TaskFinalizeSupport 早已存在,9 支 *TaskService 里 7 支已委托,跨文件逐字重复只有 208 行;真正改不动的是 16 个文件里 130 处手抄的「模块归属谓词」——它决定漏一行还是多放行一行,两处口径各自成立, 不是能机械合并的副本。 本支不重写那 130 处,只把债务钉住:谓词出现次数 ≤130、文件数==16、委托数 ≥7, 只许降不许升;每条断言带"能红"自检。 --- .../task/TaskLifecycleDebtRatchetTest.java | 169 ++++++++++++++++++ 1 file changed, 169 insertions(+) create mode 100644 backend-java/src/test/java/com/nanri/aiimage/common/task/TaskLifecycleDebtRatchetTest.java diff --git a/backend-java/src/test/java/com/nanri/aiimage/common/task/TaskLifecycleDebtRatchetTest.java b/backend-java/src/test/java/com/nanri/aiimage/common/task/TaskLifecycleDebtRatchetTest.java new file mode 100644 index 000000000..d8b72ec93 --- /dev/null +++ b/backend-java/src/test/java/com/nanri/aiimage/common/task/TaskLifecycleDebtRatchetTest.java @@ -0,0 +1,169 @@ +package com.nanri.aiimage.common.task; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.fail; + +import java.io.IOException; +import java.nio.charset.StandardCharsets; +import java.nio.file.Files; +import java.nio.file.Path; +import java.util.ArrayList; +import java.util.List; +import java.util.stream.Stream; +import com.nanri.aiimage.testutil.SourceScan; +import org.junit.jupiter.api.Test; + +/** + * 任务面「生命周期骨架」的账(2026-10-07 架构三期,第 5 项)。 + * + *
评审时那句「~3.6k 行冗余」是我自己给的,实跑之后不成立,这里换成量出来的数: + * 九个 {@code *TaskService} 归一化后共 15,295 行,跨文件逐字相同的 8 行窗口只覆盖 208 行 + * (按页 0.4%–6.8% 不等)。所以"抽骨架"不是去重——那是一场重写,而骨架早就抽过了: + * {@code TaskFinalizeSupport}(loadTaskForExecution / loadTaskMapByIds / markResultFailed / + * acquireTaskLockOrThrow / selectTasksByIdsInBatches)今天被 14 个 {@code *TaskService} 中的 7 个委托, + * 类注释里还点名留了三处非同构变体(PriceTrack 要求缓存行 requestJson 非空、ShopMatch 带新旧复活防护、 + * Withdraw 先按 limit(50) 归一化 id)。剩下的重复不是行,是同一条安全谓词被手抄的遍数: + * 「这一行是不是这个模块的」{@code !MODULE_TYPE.equals(x.getModuleType())} 在 16 个文件里写了 + * 130 遍。第 3 项那个超管判定是同一缺陷的小一号版本(19 遍),那个已经收口成出口,这个还没有。
+ * + *抄本身不是 bug,改不动才是:归属谓词漏一处的表现是某一页的检查静默变成"谁都能读", + * 不报错、不 403。今天动它要一次改到 16 个文件,代价太大,所以这里先把遍数钉成棘轮: + * 只许降不许升。升了就是在新增第十七处手写归属——那种新增应当接进 {@code TaskFinalizeSupport} + * 或新的归属出口,而不是把这个数字调大。
+ * + *两条判据各带自检:锚点必须真能抓到这一形,否则"16 个文件 / 130 处"的 0 命中与扫不到同形。
+ */ +class TaskLifecycleDebtRatchetTest { + + private static final String MODULE_OWNERSHIP = "!MODULE_TYPE.equals("; + + @Test + void handWrittenModuleOwnershipIsPinnedAtOneHundredThirtyAndCannotGrow() { + int occurrences = 0; + List缺了后一半,{@code withoutComments} 写坏成"整行都删"也会一路绿;缺了前一半, + * 有人把骨架零件改名而在类注释里留一句说明,"零件不见了"就变成假红。
+ */ + @Test + void commentTextFeedsNeitherShape() { + String proseOnly = SourceScan.withoutComments(""" + /** 骨架里有 loadTaskForExecution( 与 TaskFinalizeSupport. 这些名字,只是文档。 */ + class C { + // if (task == null || !MODULE_TYPE.equals(task.getModuleType())) { } + void h() { } + } + """); + assertThat(count(proseOnly, MODULE_OWNERSHIP)) + .as("注释里的归属谓词不得算命中(棘轮分母会被文档喂大)").isZero(); + assertThat(proseOnly).doesNotContain("loadTaskForExecution(").doesNotContain("TaskFinalizeSupport."); + assertThat(proseOnly).as("剥注释不许把代码骨架一起吃掉(类声明还在)") + .contains("class C").contains("void h()"); + + String realCode = SourceScan.withoutComments(""" + class C { + void h() { + if (task == null || !MODULE_TYPE.equals(task.getModuleType())) { throw new BizException(); } + } + } + """); + assertThat(count(realCode, MODULE_OWNERSHIP)) + .as("同一把尺子必须抓得到真代码,否则「0 命中」与「扫不到」同形").isEqualTo(1); + // 字符串字面量里的 // 不算注释:口径写坏了会把整行吃掉,这里钉住 + assertThat(SourceScan.withoutComments("String u = \"https://a\"; // tail").contains("https://a")) + .isTrue(); + } +}