回传洪水收口(货源+外观): 「任务不是运行中」4 处出口归一进 TaskResultAdmission——真终态(SUCCESS/FAILED)带 40901,异常处理器按幂等成功回 success=true,客户端据此删本地副本停止补发;PENDING 不带码保持可重试(建单就写它,判死=丢还能送到的结果)

判据=两条链 setStatus 实测只有 PENDING/RUNNING/SUCCESS/FAILED,故取 FINISHED_ORDERED 不取 TERMINAL(取消态无证据);摘两支重复 helper 与因此空转的 1 处 BusinessCodes import;TaskDistributedLockService 补 [task-lock-held] 持锁时长留痕(>=5s info/>=60s warn),此前只有 WAIT_LLM 量得出时长
验证=后端全量 4291 passed 0 failed(skipped 7, 6.0min);正反各两支新用例钉死;变异 M1 摘码/M2 全状态带码各杀 2 红、还原字节一致;M3 换成 TERMINAL 无人判红=已知盲区(写进类注释);可读性棘轮 9 格绿(PipelineSupport 缩回 1975 行/基线 1978)
This commit is contained in:
2026-10-12 01:22:43 +08:00
parent b0829db81e
commit 1e3bcc9688
6 changed files with 100 additions and 4 deletions
@@ -0,0 +1,31 @@
package com.nanri.aiimage.common.task;
import com.nanri.aiimage.common.exception.BusinessCodes;
import com.nanri.aiimage.common.exception.BusinessException;
/**
* 「任务不在运行中」这一句拒绝的统一出口(2026-10-11 现网取证:结果补发洪水单设备一天 14,906 行)。
*
* <p>只有真终态才许带 40901:异常处理器对它按幂等成功返回 {@code success=true},客户端见 success=true
* 就删本地副本、停止补发。{@code PENDING} 是建单就写的状态,回传撞上它只是「激活比投递慢一步」,
* 结果必须留着补发——给它判死等于把还能送到的数据丢掉。
*
* <p>终态取 {@link TaskStatuses.FileTask#FINISHED_ORDERED}(SUCCESS/FAILED)而不是 {@code TERMINAL}:
* 货源与外观两条链的 {@code setStatus} 实测只出现 PENDING/RUNNING/SUCCESS/FAILED,从不写取消态;
* 把取消态也算成「结果不可能再落到」目前没有证据支撑。
*/
public final class TaskResultAdmission {
private TaskResultAdmission() {
}
/** 任务不在运行中:真终态带 40901 让客户端收口,其余状态(含空值)不带码、保持可重试。 */
public static void rejectNotRunning(String status) {
// FINISHED_ORDERED 是 List.of(...),contains(null) 直接抛 NPE;这里必须自己挡住,
// 否则摘掉本地 equals 判法之后,空状态会从「可重试拒绝」变成 500。
if (status != null && TaskStatuses.FileTask.FINISHED_ORDERED.contains(status)) {
throw new BusinessException(BusinessCodes.TASK_ALREADY_FINISHED, "任务不是运行中状态");
}
throw new BusinessException("任务不是运行中状态");
}
}