From 6a43a7e74542daf750256904366ec484ecf56544 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=BB=84=E8=87=AA=E8=BE=BE?= <980324341@qq.com> Date: Mon, 19 Oct 2026 17:56:34 +0800 Subject: [PATCH] =?UTF-8?q?docs(phase-3):=203D=20=E5=89=8D=E7=BD=AE?= =?UTF-8?q?=E5=87=BA=E5=A4=84=E8=B4=A6=E2=80=94=E2=80=94=E5=BA=95=E5=BA=A7?= =?UTF-8?q?=E6=8A=8A=20Publish=20=E8=AE=B0=E6=88=90=20TerminalRejection#ER?= =?UTF-8?q?ROR=20=E7=9A=84=E5=87=BA=E5=A4=84=E8=BF=99=E4=B8=80=E7=AC=94?= =?UTF-8?q?=E4=B8=8D=E5=AE=9E=EF=BC=8C=E6=94=B9=E8=AE=B0=E6=88=90=E7=AC=AC?= =?UTF-8?q?=E4=B8=89=E7=A7=8D=E5=BD=A2=E7=8A=B6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 纯 javadoc,一行生产逻辑未动(`git diff --stat` = 12+/4−,全在注释块内)。 3D 前置 golden(上一枚 commit)逐段读完 publish 的终态后,发现底座 `TerminalRejection#ERROR` 那段注释里两处不实: - **Publish 从来不是本档位的使用方**。Phase 2 把它按「不带 code」这一维归了类并留了个 `:1344` 指针,但 `PublishTaskService` 全文零次出现「任务已结束」;它真实的两处是 `:1104-1108`/`:1137-1141`,形状是本枚举**没建模的第三种**:SUCCESS 静默返回(不抛),FAILED 才抛「任务已失败,拒绝继续回传」。golden 的 `taskSuccessShortCircuitsWithoutThrowing` = 两次 `task.load` + `tx.begin/commit`、零写入、`result=void` 就是这条的物证。 - **ShopDataCrawl 的 `:633` 指针也已漂**(那行现在是建单段的 `newTaskHeader`),真出处是 `submitResult` 里 `:676`。连同 `IDEMPOTENT` 段的 ShopMatch `:652`/PriceTrack `:603`(实测在 `:675`/`:642`)一起,本笔一律改成**认方法名不认行号**——这正是 3C 那笔给 CollectData 立过的规矩,当时只改了 CollectData 一支的行,剩下三支的行号照旧漂着。 对 3D 的直接结论:publish 接底座时这一格既不能套 IDEMPOTENT 也不能套 ERROR,只能留本地写法、或先给枚举加第三档;加档属公共形状变更,要单独授权。这一格与 `:1104` 那处的「锁外预检」合起来,是 publish 与 collectdata 虽同属 chunk+scope 族、却不能照抄迁移的两处硬差。 门禁:`mvn -o test-compile` rc=0;ratchet/护栏七类合跑 `Tests run: 77, Failures: 0`(含 `CatchSilenceRatchetTest` 9、`SourceScanTest` 40、`LockSkipSilentExitGuardrailTest` 4);ops readability ratchet 9 passed——本件现 551 行(ruler 口径),距 800 报警线尚有 249 行,注释变厚不构成新 offender。全量 4537 已在上枚 commit 前跑过,本笔只动注释、不重复消耗。 --- .../pipeline/AbstractFileTaskPipeline.java | 16 ++++++++++++---- 1 file changed, 12 insertions(+), 4 deletions(-) diff --git a/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/pipeline/AbstractFileTaskPipeline.java b/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/pipeline/AbstractFileTaskPipeline.java index da3bb623f..c8ef31398 100644 --- a/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/pipeline/AbstractFileTaskPipeline.java +++ b/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/pipeline/AbstractFileTaskPipeline.java @@ -89,20 +89,28 @@ public abstract class AbstractFileTaskPipeline { /** * 带 {@link BusinessCodes#TASK_ALREADY_FINISHED}(40901): * {@code GlobalExceptionHandler} 转 HTTP 200 + success=true,Python 侧按幂等忽略、停止重试。 - * 现网出处:ShopMatch{@code :652}/PriceTrack{@code :603}/CollectData——3C 实测这一支是**七支里 - * 唯一把本件用两次的**({@code submitResult} 的锁外预检+锁内复核;迁移前那两个 {@code 40901} - * 抛出点在 {@code :864/:904},迁后行号不再作数,认方法名)。 + * 现网出处(一律认方法名, migrated 件的行号每笔都在漂):ShopMatch/PriceTrack 的 {@code submitResult} + * 把本档位当参数交给 {@code submitShopScopedResults};CollectData 的 {@code submitResult} 是**七支里 + * 唯一把本件用两次的**(锁外预检+锁内复核)。 */ IDEMPOTENT, /** * 不带 code({@code BusinessException(String)}):响应 success=false,调用方会当错误处理。 - * 现网出处:ShopDataCrawl {@code :633}/Publish {@code :1344}——两支文案就是本件那句 + * 现网出处**只有 ShopDataCrawl 一支**——它的 {@code submitResult} 用本档位,文案即本件那句 * 「任务已结束,拒绝重复提交」。 * *

3E 实测补正:{@code DeleteBrandRunService:1384} 同属不带 code 这一形,文案却只有 * 「任务已结束」。本件把文案写死了,所以那一支接不上、留本地写法(它的回传段 golden * {@code terminalTaskRejected} 逐字钉着这句)。Phase 2 原先把 DeleteBrand 列在本件出处里, * 是按「有无 code」这一维归的类,文案那一维当时没数过。 + * + *

3D 前置测绘第二处补正:Phase 2 把 Publish 列在本档位出处里,那条不实。 + * {@code PublishTaskService} 全文零次出现「任务已结束」,它的终态是本枚举没建模的第三种形状: + * SUCCESS 不抛、静默返回({@code prepareResultSubmission} 返回空 prepared、{@code submitResultLocked} + * 返回 {@code commit(false, 空集)}),只有 FAILED 抛「任务已失败,拒绝继续回传」。 + * 证据:回传段 golden {@code taskSuccessShortCircuitsWithoutThrowing} 逐段钉着「两次 task.load + + * tx.begin/commit、零写入、result=void」。所以 3D 接底座的这一格既不能套 IDEMPOTENT 也不能套 ERROR, + * 得留本地写法或先给枚举加第三档——这是形状差,不是行号差。 */ ERROR }