diff --git a/backend-java/src/main/java/com/nanri/aiimage/modules/appearancepatent/service/support/AppearancePatentResultJobSupport.java b/backend-java/src/main/java/com/nanri/aiimage/modules/appearancepatent/service/support/AppearancePatentResultJobSupport.java index f644fdfcc..76c3f9798 100644 --- a/backend-java/src/main/java/com/nanri/aiimage/modules/appearancepatent/service/support/AppearancePatentResultJobSupport.java +++ b/backend-java/src/main/java/com/nanri/aiimage/modules/appearancepatent/service/support/AppearancePatentResultJobSupport.java @@ -26,6 +26,7 @@ import com.nanri.aiimage.modules.task.service.TaskDistributedLockService; import com.nanri.aiimage.modules.task.service.TaskFileJobService; import com.nanri.aiimage.modules.task.service.TaskFinalizeSupport; import com.nanri.aiimage.modules.task.service.TaskRetryEligibility; +import com.nanri.aiimage.modules.task.service.support.TaskFailureLedger; import lombok.extern.slf4j.Slf4j; import org.apache.poi.xssf.streaming.SXSSFWorkbook; @@ -227,6 +228,7 @@ public class AppearancePatentResultJobSupport { task.setFailedFileCount(failed ? 1 : 0); // 缺口只写在消息里,不参与 failed 计算:95% 以上有结论的单仍是成功,但用户要看得见"N 行没检测完" task.setErrorMessage(deliverySupport.appendDeliveryGapMessage(finalError, deliveryFacts)); + task.setFailureCategory(TaskFailureLedger.categoryOf(task.getErrorMessage())); task.setUpdatedAt(LocalDateTime.now()); task.setFinishedAt(waitingForAssemble ? null : LocalDateTime.now()); fileTaskMapper.updateById(task); @@ -295,6 +297,7 @@ public class AppearancePatentResultJobSupport { task.setSuccessFileCount(0); task.setFailedFileCount(1); task.setErrorMessage(terminalMessage); + task.setFailureCategory(TaskFailureLedger.categoryOf(task.getErrorMessage())); task.setUpdatedAt(LocalDateTime.now()); task.setFinishedAt(LocalDateTime.now()); fileTaskMapper.updateById(task); @@ -472,6 +475,7 @@ public class AppearancePatentResultJobSupport { task.setFailedFileCount(failed ? 1 : 0); // 成功时也保留缺口文案:用户要看到“N 行抓取失败”,但不能因此把整单判死、逼他重跑。 task.setErrorMessage(deliverySupport.appendDeliveryGapMessage(existingError, deliveryFacts)); + task.setFailureCategory(TaskFailureLedger.categoryOf(task.getErrorMessage())); task.setUpdatedAt(LocalDateTime.now()); task.setFinishedAt(LocalDateTime.now()); fileTaskMapper.updateById(task); @@ -488,6 +492,7 @@ public class AppearancePatentResultJobSupport { boolean finalizeInterruptedDelivery(FileTaskEntity task, TaskFileJobEntity job, int totalProgressUnits, String existingError, AppearancePatentRowOutcome.Facts deliveryFacts) { task.setErrorMessage(deliverySupport.appendDeliveryGapMessage(existingError, deliveryFacts)); + task.setFailureCategory(TaskFailureLedger.categoryOf(task.getErrorMessage())); task.setUpdatedAt(LocalDateTime.now()); fileTaskMapper.updateById(task); taskCacheService.deleteTaskCache(task.getId()); diff --git a/backend-java/src/main/java/com/nanri/aiimage/modules/collectdata/service/CollectDataService.java b/backend-java/src/main/java/com/nanri/aiimage/modules/collectdata/service/CollectDataService.java index d43e1d7ed..a764a85e2 100644 --- a/backend-java/src/main/java/com/nanri/aiimage/modules/collectdata/service/CollectDataService.java +++ b/backend-java/src/main/java/com/nanri/aiimage/modules/collectdata/service/CollectDataService.java @@ -100,6 +100,7 @@ import com.nanri.aiimage.modules.task.model.vo.TaskProgressLightBatchVo; import com.nanri.aiimage.modules.task.service.TaskProgressLightAssembler; import com.nanri.aiimage.modules.task.service.StaleTaskHeartbeatPolicy; import com.nanri.aiimage.modules.task.service.pipeline.AbstractFileTaskPipeline; +import com.nanri.aiimage.modules.task.service.support.TaskFailureLedger; @Service @Slf4j @@ -538,6 +539,7 @@ public class CollectDataService extends AbstractFileTaskPipeline 0) { @@ -496,6 +499,7 @@ public class DeleteBrandStaleTaskService { .eq(FileTaskEntity::getStatus, "RUNNING") .set(FileTaskEntity::getStatus, "FAILED") .set(FileTaskEntity::getErrorMessage, "长时间未收到 Python 结果回传,任务已自动失败") + .set(FileTaskEntity::getFailureCategory, TaskFailureLedger.categoryOf("长时间未收到 Python 结果回传,任务已自动失败")) .set(FileTaskEntity::getUpdatedAt, LocalDateTime.now()) .set(FileTaskEntity::getFinishedAt, LocalDateTime.now())); if (updated > 0) { @@ -577,6 +581,7 @@ public class DeleteBrandStaleTaskService { .eq(FileTaskEntity::getStatus, "RUNNING") .set(FileTaskEntity::getStatus, "FAILED") .set(FileTaskEntity::getErrorMessage, "长时间未收到 Python 结果回传,任务已自动失败") + .set(FileTaskEntity::getFailureCategory, TaskFailureLedger.categoryOf("长时间未收到 Python 结果回传,任务已自动失败")) .set(FileTaskEntity::getUpdatedAt, LocalDateTime.now()) .set(FileTaskEntity::getFinishedAt, LocalDateTime.now())); if (updated > 0) { @@ -654,6 +659,7 @@ public class DeleteBrandStaleTaskService { .eq(FileTaskEntity::getStatus, "RUNNING") .set(FileTaskEntity::getStatus, "FAILED") .set(FileTaskEntity::getErrorMessage, "长时间未收到 Python 结果回传,任务已自动失败") + .set(FileTaskEntity::getFailureCategory, TaskFailureLedger.categoryOf("长时间未收到 Python 结果回传,任务已自动失败")) .set(FileTaskEntity::getUpdatedAt, LocalDateTime.now()) .set(FileTaskEntity::getFinishedAt, LocalDateTime.now())); if (updated > 0) { @@ -730,6 +736,7 @@ public class DeleteBrandStaleTaskService { .eq(FileTaskEntity::getStatus, "RUNNING") .set(FileTaskEntity::getStatus, "FAILED") .set(FileTaskEntity::getErrorMessage, "长时间未收到 Python 结果回传,任务已自动失败") + .set(FileTaskEntity::getFailureCategory, TaskFailureLedger.categoryOf("长时间未收到 Python 结果回传,任务已自动失败")) .set(FileTaskEntity::getUpdatedAt, LocalDateTime.now()) .set(FileTaskEntity::getFinishedAt, LocalDateTime.now())); if (updated > 0) { @@ -791,6 +798,7 @@ public class DeleteBrandStaleTaskService { .eq(FileTaskEntity::getStatus, "RUNNING") .set(FileTaskEntity::getStatus, "FAILED") .set(FileTaskEntity::getErrorMessage, "长时间未收到 Python 结果回传,任务已自动失败") + .set(FileTaskEntity::getFailureCategory, TaskFailureLedger.categoryOf("长时间未收到 Python 结果回传,任务已自动失败")) .set(FileTaskEntity::getUpdatedAt, LocalDateTime.now()) .set(FileTaskEntity::getFinishedAt, LocalDateTime.now())); if (updated > 0) { @@ -908,6 +916,7 @@ public class DeleteBrandStaleTaskService { .eq(FileTaskEntity::getStatus, "RUNNING") .set(FileTaskEntity::getStatus, "FAILED") .set(FileTaskEntity::getErrorMessage, buildNoResultUploadFailReason(minutes, lastResultAt, lastPosition)) + .set(FileTaskEntity::getFailureCategory, TaskFailureLedger.categoryOf(buildNoResultUploadFailReason(minutes, lastResultAt, lastPosition))) .set(FileTaskEntity::getUpdatedAt, LocalDateTime.now()) .set(FileTaskEntity::getFinishedAt, LocalDateTime.now())); if (updated > 0) { diff --git a/backend-java/src/main/java/com/nanri/aiimage/modules/shopdatacrawl/service/ShopDataCrawlTaskService.java b/backend-java/src/main/java/com/nanri/aiimage/modules/shopdatacrawl/service/ShopDataCrawlTaskService.java index 3fc79e7d1..f49a167a5 100644 --- a/backend-java/src/main/java/com/nanri/aiimage/modules/shopdatacrawl/service/ShopDataCrawlTaskService.java +++ b/backend-java/src/main/java/com/nanri/aiimage/modules/shopdatacrawl/service/ShopDataCrawlTaskService.java @@ -81,6 +81,7 @@ import java.util.UUID; import java.util.function.Supplier; import com.nanri.aiimage.modules.task.model.vo.TaskProgressLightBatchVo; import com.nanri.aiimage.modules.task.service.TaskProgressLightAssembler; +import com.nanri.aiimage.modules.task.service.support.TaskFailureLedger; @Service @Slf4j @@ -265,6 +266,7 @@ public class ShopDataCrawlTaskService extends AbstractFileTaskPipeline存在理由:重试/重开/判死原先全靠读 {@code error_message} 里的中文子串决定, + * 改一句用户可见文案就静默改行为。列是那次判断的**记账**,不是第二套词汇表—— + * 写入一律经 {@code TaskFailureLedger},词汇表仍只有 {@code TaskRetryEligibility} 一处。 + * + *

{@code updateStrategy=ALWAYS} 是给实体式写面兜底的:{@code updateById} 默认跳过 null 字段, + * 而 {@code task.setErrorMessage(null)} 这类「清错误」的分支带不动列,会留下一列陈旧的判决。 + * 让 null 真的落库,最坏情形就是列被抹回「未登记」——读侧按文案判定,逐字等于加列之前的今天; + * 反过来(陈旧列活下来)才是会让一单被上一次失败原因判死的那种错。 + */ + @TableField(updateStrategy = FieldStrategy.ALWAYS) + private String failureCategory; private String createdBy; private Long userId; /** 创建任务的客户端设备(JWT 签名 deviceId claim,V138);历史任务为空。 */ diff --git a/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/ExpiredAccountTaskStopService.java b/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/ExpiredAccountTaskStopService.java index 01bd73923..50858ca2d 100644 --- a/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/ExpiredAccountTaskStopService.java +++ b/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/ExpiredAccountTaskStopService.java @@ -21,6 +21,7 @@ import java.time.LocalDateTime; import java.util.LinkedHashSet; import java.util.List; import java.util.Set; +import com.nanri.aiimage.modules.task.service.support.TaskFailureLedger; /** * 账号过期停任务巡检(V146,2026-10-05)。 @@ -147,6 +148,7 @@ public class ExpiredAccountTaskStopService { .in(FileTaskEntity::getStatus, STATUS_PENDING, STATUS_SCHEDULED, STATUS_RUNNING) .set(FileTaskEntity::getStatus, STATUS_FAILED) .set(FileTaskEntity::getErrorMessage, STOP_REASON) + .set(FileTaskEntity::getFailureCategory, TaskFailureLedger.categoryOf(STOP_REASON)) .set(FileTaskEntity::getFinishedAt, now)); } } diff --git a/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/ModuleHistoryCleanupService.java b/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/ModuleHistoryCleanupService.java index ac04695fb..58fcad969 100644 --- a/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/ModuleHistoryCleanupService.java +++ b/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/ModuleHistoryCleanupService.java @@ -35,6 +35,7 @@ import java.util.ArrayList; import java.util.List; import java.util.Locale; import java.util.Set; +import com.nanri.aiimage.modules.task.service.support.TaskFailureLedger; @Slf4j @Service @@ -332,7 +333,8 @@ public class ModuleHistoryCleanupService { .in(FileTaskEntity::getId, cleanupTaskIds) .set(FileTaskEntity::getResultJson, null) .set(FileTaskEntity::getRequestJson, null) - .set(FileTaskEntity::getErrorMessage, null)); + .set(FileTaskEntity::getErrorMessage, null) + .set(FileTaskEntity::getFailureCategory, null)); return fileTaskMapper.delete(new LambdaQueryWrapper() .in(FileTaskEntity::getId, cleanupTaskIds)); diff --git a/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/StaleTaskRepairService.java b/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/StaleTaskRepairService.java index de191cf99..100caee46 100644 --- a/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/StaleTaskRepairService.java +++ b/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/StaleTaskRepairService.java @@ -16,6 +16,7 @@ import org.springframework.stereotype.Service; import java.time.LocalDateTime; import java.util.ArrayList; import java.util.List; +import com.nanri.aiimage.modules.task.service.support.TaskFailureLedger; /** * 陈旧任务自动修复。 @@ -104,6 +105,7 @@ public class StaleTaskRepairService { .eq(FileTaskEntity::getStatus, STATUS_SCHEDULED) .set(FileTaskEntity::getStatus, STATUS_FAILED) .set(FileTaskEntity::getErrorMessage, reason) + .set(FileTaskEntity::getFailureCategory, TaskFailureLedger.categoryOf(reason)) .set(FileTaskEntity::getFinishedAt, now)); if (updated > 0) { log.warn("[stale-task-repair] 陈旧定时任务已标失败 count={} ids={}", updated, ids); @@ -135,6 +137,7 @@ public class StaleTaskRepairService { .eq(FileTaskEntity::getStatus, STATUS_RUNNING) .set(FileTaskEntity::getStatus, STATUS_FAILED) .set(FileTaskEntity::getErrorMessage, reason) + .set(FileTaskEntity::getFailureCategory, TaskFailureLedger.categoryOf(reason)) .set(FileTaskEntity::getFinishedAt, now)); if (updated > 0) { log.warn("[stale-task-repair] 心跳超时 RUNNING 已标失败 count={} ids={}", updated, ids); diff --git a/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/TaskClientPullService.java b/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/TaskClientPullService.java index 25d1116e3..79ddf634b 100644 --- a/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/TaskClientPullService.java +++ b/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/TaskClientPullService.java @@ -21,6 +21,7 @@ import java.util.LinkedHashMap; import java.util.List; import java.util.Locale; import java.util.Map; +import com.nanri.aiimage.modules.task.service.support.TaskFailureLedger; /** * 客户端兜底拉取:把"页面没推送成功、长期停在 PENDING"的任务交给在线客户端执行。 @@ -283,6 +284,7 @@ public class TaskClientPullService { .eq(FileTaskEntity::getStatus, STATUS_RUNNING) .set(FileTaskEntity::getStatus, STATUS_FAILED) .set(FileTaskEntity::getErrorMessage, reason) + .set(FileTaskEntity::getFailureCategory, TaskFailureLedger.categoryOf(reason)) .set(FileTaskEntity::getFinishedAt, LocalDateTime.now())); log.warn("[client-task-pull] 认领后组装载荷失败,已标失败 taskId={} moduleType={} 命中={} 原因={}", task.getId(), task.getModuleType(), updated, reason); diff --git a/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/TaskHeartbeatService.java b/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/TaskHeartbeatService.java index 7e747b14c..5814c2821 100644 --- a/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/TaskHeartbeatService.java +++ b/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/TaskHeartbeatService.java @@ -18,6 +18,7 @@ import java.time.LocalDateTime; import java.util.LinkedHashMap; import java.util.List; import java.util.Map; +import com.nanri.aiimage.modules.task.service.support.TaskFailureLedger; /** * 任务心跳入口。 @@ -173,6 +174,7 @@ public class TaskHeartbeatService { .eq(FileTaskEntity::getStatus, STATUS_RUNNING) .set(FileTaskEntity::getStatus, "FAILED") .set(FileTaskEntity::getErrorMessage, safeReason) + .set(FileTaskEntity::getFailureCategory, TaskFailureLedger.categoryOf(safeReason)) .set(FileTaskEntity::getFinishedAt, LocalDateTime.now())); if (updated > 0) { log.warn("[task-interrupted] file task marked failed by client restart taskId={} moduleType={} reason={}", @@ -231,6 +233,7 @@ public class TaskHeartbeatService { .in(FileTaskEntity::getStatus, TaskStatuses.FileTask.ACTIVE_ORDERED) .set(FileTaskEntity::getStatus, TaskStatuses.FileTask.CANCELLED) .set(FileTaskEntity::getErrorMessage, message) + .set(FileTaskEntity::getFailureCategory, TaskFailureLedger.categoryOf(message)) .set(FileTaskEntity::getFinishedAt, LocalDateTime.now())); if (updated > 0) { log.warn("[task-cancel] file task cancelled by user taskId={} moduleType={}", diff --git a/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/TaskInPlaceRetryService.java b/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/TaskInPlaceRetryService.java index f744b6e6c..2b8c5722d 100644 --- a/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/TaskInPlaceRetryService.java +++ b/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/TaskInPlaceRetryService.java @@ -14,6 +14,7 @@ import lombok.extern.slf4j.Slf4j; import org.springframework.stereotype.Service; import java.time.LocalDateTime; +import com.nanri.aiimage.modules.task.service.support.TaskFailureLedger; /** * 失败/中断任务「在原任务上重试/继续」的唯一出口(2026-11-01 用户拍板失败重试; @@ -81,6 +82,7 @@ public class TaskInPlaceRetryService { .in(FileTaskEntity::getStatus, STATUS_FAILED, STATUS_CANCELLED) .set(FileTaskEntity::getStatus, STATUS_PENDING) .set(FileTaskEntity::getErrorMessage, null) + .set(FileTaskEntity::getFailureCategory, null) .set(FileTaskEntity::getFinishedAt, null) .set(FileTaskEntity::getResumeAttempt, attempt + 1) .set(FileTaskEntity::getUpdatedAt, now)); diff --git a/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/TaskResumeService.java b/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/TaskResumeService.java index 87e0e489e..f34546364 100644 --- a/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/TaskResumeService.java +++ b/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/TaskResumeService.java @@ -19,6 +19,7 @@ import java.util.List; import java.util.Locale; import java.util.Map; import java.util.Set; +import com.nanri.aiimage.modules.task.service.support.TaskFailureLedger; /** * 失败任务的自动重试:把仍可执行的原任务**克隆**成一条新的 PENDING 任务,最多重试 3 代。 @@ -213,7 +214,9 @@ public class TaskResumeService { continue; } TaskRetryEligibility.Category notRetryable = - TaskRetryEligibility.forceMajeureCategory(original.getErrorMessage()); + // 双读(B51-R1):这行登记过分类就以列为准,没登记才回落到文案——自动续跑 + // 是每天真在跑的判死面,不该让"某句话改了措辞"在这种地方动摇历史行的判定。 + TaskRetryEligibility.category(original); if (notRetryable != null) { stats.forceMajeureSkippedCount++; // 这句不再自称"不可抗力":category=STOPPED 是我们自己停的,写成不可抗力会把运维 @@ -360,6 +363,7 @@ public class TaskResumeService { .in(FileTaskEntity::getStatus, LIVE_STATUSES) .set(FileTaskEntity::getStatus, STATUS_FAILED) .set(FileTaskEntity::getErrorMessage, DUPLICATE_STOP_REASON) + .set(FileTaskEntity::getFailureCategory, TaskFailureLedger.categoryOf(DUPLICATE_STOP_REASON)) .set(FileTaskEntity::getFinishedAt, LocalDateTime.now()) .set(FileTaskEntity::getUpdatedAt, LocalDateTime.now())); if (updated == 1) { diff --git a/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/TaskRetryEligibility.java b/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/TaskRetryEligibility.java index d5fa84d3a..fda4d64ff 100644 --- a/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/TaskRetryEligibility.java +++ b/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/TaskRetryEligibility.java @@ -1,5 +1,7 @@ package com.nanri.aiimage.modules.task.service; +import com.nanri.aiimage.modules.task.model.entity.FileTaskEntity; + import java.util.List; import java.util.Locale; @@ -119,6 +121,50 @@ public final class TaskRetryEligibility { return category == null ? "" : category.label(); } + /** + * 双读入口(B51-R1 的 Expand 半边):文案还判得出就按文案,判不出才轮到 + * {@code biz_file_task.failure_category} 里登记的那一笔。 + * + *

列是「那次判断的结果」,文案是「给人看的一句话」——判生死不该挂在一句话的措辞上, + * 所以措辞漂移到 markers 认不出时,判决仍由列钉在原处。存量行的列一律为空,回落就是 + * 切换前的口径,行为逐字不变。 + * + *

为什么不写成「有列就无条件读列」:{@code setErrorMessage} 的实体式写入面 + * (若干 {@code task.setErrorMessage(...)} + {@code updateById})本轮还没接 + * {@code TaskFailureLedger},它改文案时带不动列(MyBatis-Plus 默认不更新 null 字段), + * 于是同一行会出现「列记着上一次判决、文案已是另一次失败」。那种背离里列是陈旧的: + * 无条件读列等于让一个已经不代表当前失败原因的值判死这一单——那是本笔改动自己引入的行为漂移, + * 比它要修的 bug 更糟。两者都能判出却不同类时按文案读,逐字等于加列之前的今天。 + * + *

不在值域内的字符串按「没登记」处理并回落,不写成 {@code valueOf} + catch: + * 静默 catch 会计入 {@code CatchSilenceRatchetTest} 的总数上限(铁律 19 的 2026-10-31 实录, + * 加 2 处就把后端整量打红),逐值比对同样不抛。 + */ + public static Category category(FileTaskEntity task) { + if (task == null) { + return null; + } + Category fromMessage = forceMajeureCategory(task.getErrorMessage()); + if (fromMessage != null) { + return fromMessage; + } + return categoryByName(task.getFailureCategory()); + } + + /** 按值逐个比对枚举名;空串或不在值域内一律返回 null(=未登记),不抛异常。 */ + public static Category categoryByName(String raw) { + if (raw == null || raw.isBlank()) { + return null; + } + String name = raw.trim(); + for (Category category : Category.values()) { + if (category.name().equals(name)) { + return category; + } + } + return null; + } + private static boolean containsAny(String text, List markers) { for (String marker : markers) { if (text.contains(marker)) { diff --git a/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/support/TaskFailureLedger.java b/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/support/TaskFailureLedger.java new file mode 100644 index 000000000..40ae42bcd --- /dev/null +++ b/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/support/TaskFailureLedger.java @@ -0,0 +1,31 @@ +package com.nanri.aiimage.modules.task.service.support; + +import com.nanri.aiimage.modules.task.service.TaskRetryEligibility; + +/** + * 任务失败分类的写入口(B51-R1,{@code docs/REFACTOR_PLAN.md} §3.1)。 + * + *

它只做一件事:把「这段文案属于哪一类」的判断结果记进 + * {@code biz_file_task.failure_category},与文案同笔落库。判定逻辑本身仍然只有 + * {@link TaskRetryEligibility} 一处——本类不复制词汇表,否则就又造出一个第二正本(B52 那一族)。 + * + *

为什么列和文案要同时写:判死/重试/重开原先只读中文子串,改一句用户看得见的文案就 + * 静默改一次整单生死。列落下之后,读侧「文案判得出按文案、判不出按列」,文案怎么改都不再动摇已登记的判定。 + * + *

返回 {@code null} 有两种来源,读侧同待:① 文案确实不属于任何一类(普通可重试失败); + * ② 这一行还没接上本出口(实体式写入面,Contract 阶段之前分批补齐)。不许把空列读成 + * 「分类为 UNKNOWN」——那会让存量行在切换日集体变成一种新状态。实体式 {@code setErrorMessage} + * 改文案时带不动列(MyBatis-Plus 默认不更新 null 字段),所以那一面在接上 ledger 之前会出现 + * 「列记着上一次判决、文案已是另一次失败」的背离;读侧按文案优先,正是为了不让这种陈旧列判死这一单。 + */ +public final class TaskFailureLedger { + + private TaskFailureLedger() { + } + + /** 由失败文案推出分类名({@code TaskRetryEligibility.Category.name()});判不出返回 null。 */ + public static String categoryOf(String errorMessage) { + TaskRetryEligibility.Category category = TaskRetryEligibility.forceMajeureCategory(errorMessage); + return category == null ? null : category.name(); + } +} diff --git a/backend-java/src/main/resources/db/V186__task_failure_category.sql b/backend-java/src/main/resources/db/V186__task_failure_category.sql new file mode 100644 index 000000000..53711b4f8 --- /dev/null +++ b/backend-java/src/main/resources/db/V186__task_failure_category.sql @@ -0,0 +1,30 @@ +-- V186: 任务失败分类列(B51-R1,Expand-and-Contract 的 Expand 半边) +-- +-- 背景(蓝图 docs/REFACTOR_PLAN.md §3.1,立项自 docs/audit/SLIMMING_REPORT.md 的 B51): +-- 重试/重开/判死全部读 `biz_file_task.error_message` 里的**中文子串**决定 +-- (TaskRetryEligibility 六组 markers、TaskResultFileJobWorker 的孤儿判死、 +-- SimilarAsinStaleReopenSupport 的重开白名单)。后果是"改一句用户看得见的文案"= +-- 静默改一次整单生死,而且改的人不会知道——文案是给看的,判定是拿它当枚举用的。 +-- +-- 设计口径: +-- * 可空:NULL=「这一行没登记分类」。存量行一律不回填(历史行的文案还在,读侧照旧能判), +-- 实体式写入面(若干 `task.setErrorMessage(...)`)本轮尚未接 ledger,落库时列为空—— +-- 这两种 NULL 都是**有意的**,读侧按「文案判得出按文案、判不出按列」双读(列与文案背离时 +-- 列是陈旧的,按文案才等于加列之前的行为),不许把空列读成「无类别」; +-- * 不自造第二套词汇表:值域就是 `TaskRetryEligibility.Category.name()` +-- (BALANCE/SERVICE_DOWN/CREDENTIAL/DELIVERY/STOPPED),判定逻辑仍只有那一处; +-- * VARCHAR(16) 与 V183 的 `collect_channel` 同档:五个枚举名最长 12(SERVICE_DOWN), +-- 留余量给后续分类名,不用 ENUM(ENUM 改值域要再发一次迁移,且 MyBatis 侧映射成字符串更直白); +-- * 不加索引:这一列现在只被"读某一行的分类"用到(按主键),没有按分类筛整表的查询; +-- 真要按类别统计再说,别让一条推测性索引进基线。 +-- +-- Contract 阶段(本轮**不做**,读侧全切之后才许动): +-- 把 `contains("<中文>")` 那批判定收掉,并让 `TaskFailureCategoryGuardrailTest` +-- 的"文案写点必须同笔写列"绊线继续守着新增点。 +-- +-- 回滚(手工): +-- ALTER TABLE `biz_file_task` DROP COLUMN `failure_category`; + +ALTER TABLE `biz_file_task` + ADD COLUMN `failure_category` VARCHAR(16) NULL + COMMENT '失败分类(TaskRetryEligibility.Category 值域):空=未登记,读侧回落到 error_message 文案判定' AFTER `error_message`; diff --git a/backend-java/src/test/java/com/nanri/aiimage/config/TaskFailureCategoryMigrationV186Test.java b/backend-java/src/test/java/com/nanri/aiimage/config/TaskFailureCategoryMigrationV186Test.java new file mode 100644 index 000000000..b978109df --- /dev/null +++ b/backend-java/src/test/java/com/nanri/aiimage/config/TaskFailureCategoryMigrationV186Test.java @@ -0,0 +1,116 @@ +package com.nanri.aiimage.config; + +import com.baomidou.mybatisplus.annotation.FieldStrategy; +import com.baomidou.mybatisplus.annotation.TableField; +import com.nanri.aiimage.modules.task.model.entity.FileTaskEntity; +import com.nanri.aiimage.modules.task.service.TaskRetryEligibility; +import org.junit.jupiter.api.Test; + +import java.io.IOException; +import java.nio.file.Files; +import java.nio.file.Path; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * V186 给 {@code biz_file_task} 补 {@code failure_category} 列,本类钉它的形状(B51-R1 Expand 半边)。 + * + *

立账出处是蓝图 {@code docs/REFACTOR_PLAN.md} §3.1 与 SLIMMING 报告的 B51:重试/重开/判死 + * 原先全靠读 {@code error_message} 的中文子串决定,改一句用户看得见的文案就静默改一次整单生死。 + * 这一列把「那次判断的结果」记下来,读侧从此有列读列。 + * + *

三件事各守一个炸法: + *

    + *
  1. 必须可空且不回填:存量行与尚未接 {@code TaskFailureLedger} 的实体式写入面都是 NULL, + * 读侧按「无列则回落文案」处理。加 {@code NOT NULL} 或 {@code DEFAULT ''} 会让存量行在 + * 迁移那一刻集体变成一种新状态;写一条 {@code UPDATE} 回填更是把「分类」变成 + * 「按今天的文案重判一遍历史」——历史行的判定不该被后来的词汇表改动。
  2. + *
  3. 值域不另起炉灶:列宽必须容得下 {@code TaskRetryEligibility.Category} 的全部枚举名, + * 且 SQL 里点名的出处就是那一处(否则 B52 那族「词汇表多正本」在这里重生)。
  4. + *
  5. 列名与实体字段对齐:MyBatis-Plus 靠驼峰↔下划线映射,列名与字段名对不上时 + * 写入会静默不落库(列存在但恒为 NULL,读侧永远回落,等于白加)。
  6. + *
+ */ +class TaskFailureCategoryMigrationV186Test { + + private static final Path SQL = Path.of(System.getProperty("user.dir"), + "src/main/resources/db/V186__task_failure_category.sql"); + + private static String sql() throws IOException { + assertTrue(Files.exists(SQL), "V186 迁移脚本不在:" + SQL); + return Files.readString(SQL); + } + + @Test + void 列是biz_file_task上的可空窄列且紧跟error_message() throws IOException { + String text = sql(); + + assertTrue(text.contains("ALTER TABLE `biz_file_task`"), "迁移对象必须是 biz_file_task"); + assertTrue(text.contains("ADD COLUMN `failure_category` VARCHAR(16) NULL"), + "必须是可空窄列:NOT NULL/DEFAULT 都会让存量行集体变成一种新状态"); + assertTrue(text.contains("AFTER `error_message`"), + "紧跟 error_message:这两列是一件事的记账与文案,读的人要能一眼成对"); + assertFalse(text.toUpperCase().contains("UPDATE `BIZ_FILE_TASK`"), + "Expand 阶段不回填:历史行的判定不能按今天的词汇表重判一遍"); + assertTrue(text.contains("DROP COLUMN `failure_category`"), + "回滚语句必须写在脚本注释里(与 V183 同一口径)"); + } + + @Test + void 头注释版本号与文件名一致() throws IOException { + String first = sql().lines().findFirst().orElse(""); + assertTrue(first.startsWith("-- V186:"), "头注释必须写 V186,实际是:" + first); + } + + @Test + void 列宽容得下词汇表的每一个枚举名() throws IOException { + String text = sql(); + int width = Integer.parseInt(text.replaceAll("(?s).*`failure_category` VARCHAR\\((\\d+)\\).*", "$1")); + int longest = 0; + for (TaskRetryEligibility.Category category : TaskRetryEligibility.Category.values()) { + longest = Math.max(longest, category.name().length()); + } + assertTrue(width >= longest, + "列宽 " + width + " 装不下最长的枚举名(" + longest + " 字符)⇒ 写入会被截断或报错"); + assertTrue(text.contains("TaskRetryEligibility.Category"), + "SQL 注释必须点明值域出处就是那一处词汇表,不许另造一套"); + } + + /** 列名与实体字段对不上时 MyBatis-Plus 会静默不落库:这一格把两者绑死。 */ + @Test + void 实体字段与列名按驼峰下划线一一对应() throws Exception { + assertNotNull(FileTaskEntity.class.getDeclaredField("failureCategory"), + "实体缺 failureCategory 字段 ⇒ 列永远不会被写"); + assertEquals("failure_category", camelToSnake("failureCategory")); + assertTrue(sql().contains("`failure_category`")); + } + + /** + * {@code updateStrategy=ALWAYS} 是名单外实体式写面的兜底:默认策略跳过 null 字段, + * 于是「partial entity 更新」会把这一列留在旧值上——陈旧的一列比没有列更危险(它会让一单 + * 被上一次失败的原因判死)。让 null 真的落库,最坏只是退回文案判定,逐字等于加列之前的今天。 + */ + @Test + void 实体字段必须让_null_真的落库() throws Exception { + TableField field = FileTaskEntity.class.getDeclaredField("failureCategory") + .getAnnotation(TableField.class); + assertNotNull(field, "failureCategory 没标 @TableField ⇒ updateById 会跳过 null,清错误的分支带不动列"); + assertEquals(FieldStrategy.ALWAYS, field.updateStrategy(), + "updateStrategy 不是 ALWAYS ⇒ 实体式更新留下陈旧分类"); + } + + private static String camelToSnake(String name) { + StringBuilder out = new StringBuilder(); + for (char c : name.toCharArray()) { + if (Character.isUpperCase(c)) { + out.append('_').append(Character.toLowerCase(c)); + } else { + out.append(c); + } + } + return out.toString(); + } +} diff --git a/backend-java/src/test/java/com/nanri/aiimage/modules/task/service/TaskFailureCategoryGuardrailTest.java b/backend-java/src/test/java/com/nanri/aiimage/modules/task/service/TaskFailureCategoryGuardrailTest.java new file mode 100644 index 000000000..23be365c4 --- /dev/null +++ b/backend-java/src/test/java/com/nanri/aiimage/modules/task/service/TaskFailureCategoryGuardrailTest.java @@ -0,0 +1,248 @@ +package com.nanri.aiimage.modules.task.service; + +import com.nanri.aiimage.modules.task.model.entity.FileTaskEntity; +import com.nanri.aiimage.testutil.SourceScan; +import org.junit.jupiter.api.Test; + +import java.io.IOException; +import java.io.UncheckedIOException; +import java.nio.file.Files; +import java.nio.file.Path; +import java.util.ArrayList; +import java.util.List; +import java.util.stream.Stream; + +import static org.assertj.core.api.Assertions.assertThat; + +/** + * 失败分类列的写入面与读侧面判据(B51-R1,Expand 半边)。 + * + *

为什么打在源码上而不是四份单测夹具:这一格要守的是「写了文案就必须同笔写列」这条 + * 连线。用 mock 造一枚任务实体测一遍分类,改天新增一处 {@code setErrorMessage} 而忘了 + * 写列,那份单测照样全绿——而这正是"改一句文案静默改判死"的复发路径。 + * + *

四件事各守一个方向: + *

    + *
  1. 每一处任务失败文案的 wrapper 写点,下一行必须同笔写 {@code failure_category} + * (把任一处配对删掉 ⇒ 本类红);
  2. + *
  3. 已接线的实体式写面({@code task.setErrorMessage + updateById},名单见 + * {@code ENTITY_FACE_FILES})必须同笔经 {@link TaskFailureLedger} 派生写列—— + * 这批写的正是判死/重试消费的那几族文案,漏列=读侧对这一行永远退回中文子串;
  4. + *
  5. 列的值只能由 {@link TaskFailureLedger} 从 {@link TaskRetryEligibility} 推导, + * ledger 自己不许再抄一份中文 markers(否则 B52 那族「词汇表多正本」在这里重生);
  6. + *
  7. 读侧「文案判得出按文案、判不出按列」:措辞漂移时列把判决钉在原处,列不在必须逐字退回 + * 原判据,存量行为一字不变;列与文案背离(名单外的实体式写点)时按文案——陈旧列不许判死。
  8. + *
+ */ +class TaskFailureCategoryGuardrailTest { + + private static final String MESSAGE_SET = ".set(FileTaskEntity::getErrorMessage, "; + private static final String CATEGORY_SET = ".set(FileTaskEntity::getFailureCategory, "; + + /** 现网在册写点的下限:低于这个数说明扫描面或写法变了,而不是"违规被修完了"。 */ + private static final int MIN_WRITE_SITES = 20; + + /** 实体式写面的接线名单(第二批):只有列在这里的文件受 {@code 已接线的实体式任务写点...} 那格管。 */ + private static final List ENTITY_FACE_FILES = List.of( + "AppearancePatentResultJobSupport.java", + "SimilarAsinTaskService.java", + "CollectDataService.java"); + + /** 名单内在册写点数(AP 4 +相似ASIN 4 +采集 1);低于它=写点被挪走或改了写法。 */ + private static final int ENTITY_FACE_MIN_WRITE_SITES = 9; + + @Test + void 任务失败文案写点必须同笔写分类列() { + List violations = new ArrayList<>(); + int sites = 0; + for (Path file : mainJavaFiles()) { + List lines = readLines(file); + for (int i = 0; i < lines.size(); i++) { + String line = lines.get(i); + if (!line.contains(MESSAGE_SET) || isComment(line)) { + continue; + } + sites++; + String paired = i + 1 < lines.size() ? lines.get(i + 1) : ""; + String self = line.contains(CATEGORY_SET) ? line : paired; + if (!self.contains(CATEGORY_SET)) { + violations.add(file.getFileName() + ":" + (i + 1) + " 只写了文案没写列"); + } else if (!pairingIsForSameMessage(line, paired)) { + violations.add(file.getFileName() + ":" + (i + 1) + " 写的列与文案不是同一个来源"); + } + } + } + assertThat(violations) + .as("biz_file_task.error_message 的每一处落库都必须把 TaskRetryEligibility 的判定结果一起记下来" + + "(B51-R1:否则读侧永远只能靠中文子串猜当时判了什么)") + .isEmpty(); + assertThat(sites) + .as("扫到的写点数低于下限=扫描面或写法变了,不是违规清零了") + .isGreaterThanOrEqualTo(MIN_WRITE_SITES); + } + + /** + * 实体式写面({@code task.setErrorMessage(...)} + {@code updateById})第二批接线。 + * + *

这三面写出的正是判死/重试真正消费的那些文案(DELIVERY/BALANCE 家族:结果文件多次生成 + * 失败、LLM 上游欠费)。它们不走 wrapper,上面那格扫不到;漏写列的后果不是崩,而是读侧对这一行 + * 永远退回中文子串——加了一列却没买到任何免疫力,这正是 B51 的病灶形状。 + * + *

名单之外(其它实体的 {@code setErrorMessage}、以及尚未接线的 {@code FileTaskEntity} 写面) + * 本格不管:按面分批收是 {@code docs/REFACTOR_PLAN.md} §5 登记的口径,Contract 阶段前逐批加进来。 + */ + @Test + void 已接线的实体式任务写点必须同笔派生写列() { + List violations = new ArrayList<>(); + int sites = 0; + for (Path file : mainJavaFiles()) { + if (!ENTITY_FACE_FILES.contains(file.getFileName().toString())) { + continue; + } + List lines = readLines(file); + for (int i = 0; i < lines.size(); i++) { + String line = lines.get(i).trim(); + if (isComment(line) || !line.startsWith("task.setErrorMessage(")) { + continue; + } + sites++; + String paired = i + 1 < lines.size() ? lines.get(i + 1).trim() : ""; + if (!paired.startsWith("task.setFailureCategory(TaskFailureLedger.categoryOf(")) { + violations.add(file.getFileName() + ":" + (i + 1) + " 只写了文案没同笔派生写列"); + } + } + } + assertThat(violations) + .as("名单内的任务实体写点必须经 TaskFailureLedger 把分类一起落库(把配对删掉即红)") + .isEmpty(); + assertThat(sites) + .as("三面在册写点数低于下限=写法变了或写点被挪走,不是违规清零了") + .isGreaterThanOrEqualTo(ENTITY_FACE_MIN_WRITE_SITES); + } + + @Test + void 分类值只能由词汇表那一处推导_ledger不得再抄一份markers() { + String ledger = SourceScan.withoutComments(SourceScan.sourceText("TaskFailureLedger.java")); + + assertThat(ledger) + .as("ledger 必须把判定委托给 TaskRetryEligibility,不自己判") + .contains("TaskRetryEligibility.forceMajeureCategory"); + assertThat(ledger) + .as("ledger 里出现 contains( =抄了第二份中文 markers 正本,B52 那族的复发形状") + .doesNotContain(".contains("); + } + + @Test + void 列登记过就读列_没登记就逐字退回文案判定() { + FileTaskEntity task = new FileTaskEntity(); + + // ① 列在、文案已漂移 ⇒ 以列为准:这就是本列存在的意义 + task.setFailureCategory(TaskRetryEligibility.Category.BALANCE.name()); + task.setErrorMessage("上游提示已更新,不再含任何已知字样"); + assertThat(TaskRetryEligibility.category(task)) + .as("文案判不出时以登记列为准——判死不随措辞漂移") + .isEqualTo(TaskRetryEligibility.Category.BALANCE); + + // ② 列没登记(存量行 / 尚未接 ledger 的实体式写入面)⇒ 逐字回落到今天的口径 + task.setFailureCategory(null); + task.setErrorMessage("LLM 服务余额欠费(上游账户额度不足,非本行数据问题)"); + assertThat(TaskRetryEligibility.category(task)) + .as("空列不等于「无类别」,必须回落到文案判定") + .isEqualTo(TaskRetryEligibility.Category.BALANCE); + + // ③ 列里是不认识的值(脏数据 / 将来改名)⇒ 同样回落,且不得抛 + task.setFailureCategory("BALANCE_BUT_TYPO"); + task.setErrorMessage("任务心跳超时,已自动失败"); + assertThat(TaskRetryEligibility.category(task)) + .as("不可识别的分类名按未登记处理:读侧不许因为一列脏值把判定改成「无可重试」") + .isNull(); + + // ④ 列与文案都判得出、却不同类 ⇒ 列是陈旧的(实体式 setErrorMessage 改文案带不动列, + // 这批写点本轮未接 ledger)。读文案=逐字等于加列之前的今天;读列就是本笔自己引入的漂移。 + task.setFailureCategory(TaskRetryEligibility.Category.BALANCE.name()); + task.setErrorMessage("已收到 73 个结果分片,但结果文件生成多次失败,任务已自动结束"); + assertThat(TaskRetryEligibility.category(task)) + .as("背离时按文案:陈旧的一列不许判死这一单") + .isEqualTo(TaskRetryEligibility.Category.DELIVERY); + } + + @Test + void 空列与脏列都不许被读成一种新状态() { + assertThat(TaskRetryEligibility.categoryByName(null)).isNull(); + assertThat(TaskRetryEligibility.categoryByName(" ")).isNull(); + assertThat(TaskRetryEligibility.categoryByName("UNKNOWN")).isNull(); + assertThat(TaskRetryEligibility.categoryByName(" balance ")).isNull(); + // 逐值比对要认得住合法值(大小写敏感:写侧落的是 name()) + assertThat(TaskRetryEligibility.categoryByName("STOPPED")) + .isEqualTo(TaskRetryEligibility.Category.STOPPED); + assertThat(TaskRetryEligibility.category(null)).isNull(); + } + + /** 配对行必须引用同一个表达式来源,防止「写了列但写的是另一句文案的分类」。 */ + private static boolean pairingIsForSameMessage(String messageLine, String categoryLine) { + String messageExpr = expressionOf(messageLine, MESSAGE_SET); + String categoryExpr = expressionOf(categoryLine, CATEGORY_SET); + if (messageExpr == null || categoryExpr == null) { + return false; + } + if (isNullish(messageExpr) || isNullish(categoryExpr)) { + // 清错误的那一侧同时清列:两边都空才是配对的 + return isNullish(messageExpr) && isNullish(categoryExpr); + } + return categoryExpr.contains(messageExpr) || messageExpr.contains(categoryExpr); + } + + private static String expressionOf(String line, String marker) { + if (line == null) { + return null; + } + int idx = line.indexOf(marker); + if (idx < 0 || isComment(line)) { + return null; + } + String tail = line.substring(idx + marker.length()); + // 从 .set( 的下一位开始配平:深度回到 0 的那个 ')' 才是本 set(...) 的闭括号, + // 链尾还挂着 update(...) 的闭括号与分号,不能按"最后一个右括号"倒推(那会把 + // `null));` 切成 `null)`,读成"不是 null")。 + int depth = 1; + for (int i = 0; i < tail.length(); i++) { + char c = tail.charAt(i); + if (c == '(') { + depth++; + } else if (c == ')') { + depth--; + if (depth == 0) { + return tail.substring(0, i).trim(); + } + } + } + return null; + } + + private static boolean isNullish(String expression) { + return "null".equals(expression) || expression.isBlank(); + } + + private static boolean isComment(String line) { + String stripped = line.trim(); + return stripped.startsWith("//") || stripped.startsWith("*") || stripped.startsWith("/*"); + } + + private static List mainJavaFiles() { + Path root = SourceScan.mainSourcesRoot(); + try (Stream stream = Files.walk(root)) { + return new ArrayList<>(stream.filter(p -> p.toString().endsWith(".java")) + .collect(java.util.stream.Collectors.toList())); + } catch (IOException ex) { + throw new UncheckedIOException("扫描面读不到:" + root, ex); + } + } + + private static List readLines(Path file) { + try { + return Files.readAllLines(file); + } catch (IOException ex) { + throw new UncheckedIOException(ex); + } + } +} diff --git a/backend-java/src/test/java/com/nanri/aiimage/modules/task/service/TaskRetryEligibilityMarkersSnapshotTest.java b/backend-java/src/test/java/com/nanri/aiimage/modules/task/service/TaskRetryEligibilityMarkersSnapshotTest.java index 82c0cbd60..485da2bf0 100644 --- a/backend-java/src/test/java/com/nanri/aiimage/modules/task/service/TaskRetryEligibilityMarkersSnapshotTest.java +++ b/backend-java/src/test/java/com/nanri/aiimage/modules/task/service/TaskRetryEligibilityMarkersSnapshotTest.java @@ -151,4 +151,40 @@ class TaskRetryEligibilityMarkersSnapshotTest { .as("只有 BusinessException 才算业务判据,运行时异常必须走正常失败重试") .isFalse(); } + + /** + * 2026-11-03 Phase 2 ⑤(B51-R1)——更新即登记,不是静默改绿。 + * + *

六组 markers 本体一字未改(上面那几格仍是正本),但读侧多了一层:任务行上登记过 + * {@code failure_category} 就以列为准,没登记才回落到这些 markers。这一格把"切换是渐进的" + * 写死——Expand 阶段存量行与未接 ledger 的写入面列都是 NULL,回落必须逐字等于今天的判定, + * 否则加一列就把历史任务的续跑口径整体改掉。 + * + *

仍留在文案判定上的三处是边界不是漏网,后续 Contract 阶段也不该顺手"切列": + * {@code TaskResultFileJobWorker#isOrphanJobFailure} 判的是查库抛回来的异常文本 + * ("任务不存在"/"task not found"),不是任务失败原因,{@code Category} 值域里也没有这一类; + * {@code AppearancePatentResultJobSupport#isFatalLlmArrearsFailure} 与 + * {@code SimilarAsinTaskService#terminalizeOnFatalLlmFailure} 判的是刚生成、尚未落库的 + * 消息,那一刻列还不存在。 + */ + @Test + void 列登记后判定不随文案漂移_未登记则逐字回落() { + com.nanri.aiimage.modules.task.model.entity.FileTaskEntity task = + new com.nanri.aiimage.modules.task.model.entity.FileTaskEntity(); + task.setFailureCategory(TaskRetryEligibility.Category.SERVICE_DOWN.name()); + task.setErrorMessage("这句文案后来被改成了任何人话"); + + assertThat(TaskRetryEligibility.category(task)) + .as("列登记过就以列为准:这正是本列存在的唯一理由") + .isEqualTo(TaskRetryEligibility.Category.SERVICE_DOWN); + + task.setFailureCategory(null); + for (String marker : List.of("余额不足", "密钥无效", "服务不可用", "aiprice 未登录", + "结果文件生成多次失败", "卡死重排")) { + task.setErrorMessage(marker); + assertThat(TaskRetryEligibility.category(task)) + .as("列不在时必须逐字退回 markers 判定:" + marker) + .isEqualTo(TaskRetryEligibility.forceMajeureCategory(marker)); + } + } } diff --git a/backend-java/src/test/java/com/nanri/aiimage/testutil/SourceScanTest.java b/backend-java/src/test/java/com/nanri/aiimage/testutil/SourceScanTest.java index ada7edea8..e923382d9 100644 --- a/backend-java/src/test/java/com/nanri/aiimage/testutil/SourceScanTest.java +++ b/backend-java/src/test/java/com/nanri/aiimage/testutil/SourceScanTest.java @@ -39,7 +39,7 @@ import static org.assertj.core.api.Assertions.assertThatThrownBy; * 那条数是 {@code grep -rl 'sourceText('} 数出来的,而第 9 支是 {@code SourceScan.java:22} 里 * {@code public static String sourceText(String fileName)} 这行被调方自己的声明——它不是调用点。 * 所以真实形状是 调用点/调用方/引用方三类数各自成立(2026-10-28 v1.1 Phase 0 起调用方 16 支、 - * 裸名 24 个,增量逐笔登记在 {@code REGISTERED_BARE_NAMES} 的注释里)。下面第 3 格把这些数同时钉住, + * 裸名 25 个,增量逐笔登记在 {@code REGISTERED_BARE_NAMES} 的注释里)。下面第 3 格把这些数同时钉住, * 免得下一个人拿 {@code grep} 再数一遍又把声明算进去。

*/ class SourceScanTest { @@ -89,7 +89,12 @@ class SourceScanTest { // 因此能算出两个归属。回落口径合并成 TaskOwnerJsonFallback 一处之后,判据只能打在 // "那一处确实按 result_json → request_json 的顺序读"这条源码连线上——mock 造不出 // "谁先谁后",四份夹具各测一遍照样全绿。 - "TaskOwnerJsonFallback.java"); + "TaskOwnerJsonFallback.java", + // —— 2026-11-03 Phase 2 ⑤(B51-R1 failure_category)追加(1 名)—— + // TaskFailureCategoryGuardrailTest 要钉「写了失败文案就必须同笔写分类列」这条连线: + // 用 mock 造任务实体测分类,挡不住"新增一处 setErrorMessage 忘了写列"—— + // 那正是"改一句文案静默改判死"的复发路径,只能打在源码上。顺带钉 ledger 不抄第二份 markers。 + "TaskFailureLedger.java"); @TempDir Path tmp; @@ -105,7 +110,7 @@ class SourceScanTest { } @Test - void census_唯一裸名恰为24且与已登记集合相等() { + void census_唯一裸名恰为25且与已登记集合相等() { Set found = SourceScan.censusSourceTextCallSites().stream() .map(SourceScan.CallSite::bareName) .collect(Collectors.toSet()); @@ -113,11 +118,11 @@ class SourceScanTest { assertThat(found) .as("唯一裸名集合必须与类头台账逐字相等——多一个说明有人新引了单文件口径,少一个说明尺子漏扫") .isEqualTo(REGISTERED_BARE_NAMES) - .hasSize(24); + .hasSize(25); } @Test - void census_调用方文件恰为17而声明件在外() { + void census_调用方文件恰为18而声明件在外() { List sites = SourceScan.censusSourceTextCallSites(); Set callerFiles = sites.stream() .map(SourceScan.CallSite::relativeFile) @@ -126,9 +131,9 @@ class SourceScanTest { String declarationFile = "src/test/java/com/nanri/aiimage/testutil/SourceScan.java"; assertThat(callerFiles) - .as("真实字面量调用点落在 17 支调用方文件里(8 支既有 + 2026-10-28 v1.1 Phase 0 预置契约 8 支" - + " + 2026-11-02 归属死锁绊线 1 支)") - .hasSize(17); + .as("真实字面量调用点落在 18 支调用方文件里(8 支既有 + 2026-10-28 v1.1 Phase 0 预置契约 8 支" + + " + 2026-11-02 归属死锁绊线 1 支 + 2026-11-03 B51-R1 双写绊线 1 支)") + .hasSize(18); assertThat(callerFiles) .as("plan 原文记的「9 支」= grep -rl 'sourceText(' 的条数,第 9 支是被调方自己的声明行" + "(SourceScan.java:22 的 `public static String sourceText(String fileName)`),"