resultFileDelivered) {
this.moduleType = moduleType;
this.taskLockTtl = taskLockTtl;
this.fileTaskMapper = fileTaskMapper;
@@ -95,6 +98,7 @@ public class AppearancePatentStaleTaskScanner {
this.properties = properties;
this.ownership = ownership;
this.submissionComplete = submissionComplete;
+ this.resultFileDelivered = resultFileDelivered;
}
public void sweep(StaleDeathFinalizer finalizer) {
@@ -165,6 +169,7 @@ public class AppearancePatentStaleTaskScanner {
taskHeartbeatPositionService.describe(taskId),
taskFileJobService.hasExhaustedAssembleJob(taskId, moduleType),
submissionComplete.test(taskId),
+ resultFileDelivered.test(taskId),
properties.getStaleTimeoutMinutes()).describe();
}
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 07e37091a..1596e817c 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
@@ -5,9 +5,11 @@ import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;
import com.nanri.aiimage.common.task.TaskStatuses;
import com.nanri.aiimage.modules.task.mapper.FileResultMapper;
import com.nanri.aiimage.modules.task.mapper.FileTaskMapper;
+import com.nanri.aiimage.modules.task.mapper.TaskChunkMapper;
import com.nanri.aiimage.modules.task.mapper.TaskFileJobMapper;
import com.nanri.aiimage.modules.task.model.entity.FileResultEntity;
import com.nanri.aiimage.modules.task.model.entity.FileTaskEntity;
+import com.nanri.aiimage.modules.task.model.entity.TaskChunkEntity;
import com.nanri.aiimage.modules.task.model.entity.TaskFileJobEntity;
import lombok.RequiredArgsConstructor;
import lombok.extern.slf4j.Slf4j;
@@ -33,14 +35,18 @@ import com.nanri.aiimage.modules.task.service.support.TaskFailureLedger;
* 只动四样东西:
*
* - 任务头:FAILED/CANCELLED → PENDING,清 error_message / finished_at,代数 +1;
- * - 结果行:清上一次的错误文案(结果文件 URL 保留,新文件生成后会覆盖;
- * 中断交付的场景由 {@link #clearDeliveredResultUrl} 显式清直链);
+ * - 结果行:清上一次的直链与错误文案(失败代也清——留着直链会让复位后的组装作业被
+ * 交付闸「已交付即跳过」在 2 秒内标回 SUCCESS,见 BACKLOG B96-08;新文件生成后覆盖挂新直链);
* - 组装作业:终态失败复位 PENDING(含卡死重排计数清零);中断已交付的 SUCCESS 作业
* 同样复位,否则「已交付跳过重复组装」闸会让复位后的作业空转;
* - 模块补检预算:从中断恢复时经 {@code ResultFileJobHandler#onTaskResumed} 清零
* (AP 的补检轮次在中断交付前往往已烧满,不清则继续后的第一轮就按部分表收尾)。
*
* 分片、scope 状态、解析载荷一律不动——它们就是续跑点。
+ *
+ * 唯一的例外是「活已经干完了」那一形状:分片已被上一轮交付清理、直链还挂着时,
+ * 重试不排回 PENDING,而是把任务补成成功终态并保留文件({@link #settleAlreadyDelivered})——
+ * 那一单没有第二代可跑,排回去只能空转一轮再被判死。
*/
@Slf4j
@Service
@@ -49,10 +55,12 @@ public class TaskInPlaceRetryService {
private static final String STATUS_FAILED = "FAILED";
private static final String STATUS_PENDING = "PENDING";
+ private static final String STATUS_SUCCESS = TaskStatuses.FileTask.SUCCESS;
private static final String STATUS_CANCELLED = TaskStatuses.FileTask.CANCELLED;
private final FileTaskMapper fileTaskMapper;
private final FileResultMapper fileResultMapper;
+ private final TaskChunkMapper taskChunkMapper;
private final TaskFileJobService taskFileJobService;
private final TaskFileJobMapper taskFileJobMapper;
private final ResultFileJobHandlerRegistry resultFileJobHandlers;
@@ -60,7 +68,8 @@ public class TaskInPlaceRetryService {
/**
* 把一条失败/已中断任务复位成待执行。幂等:只有当前状态确实是 FAILED/CANCELLED 才动作。
*
- * @return true=已复位;false=状态已不是 FAILED/CANCELLED(并发或已重试过)
+ * @return true=已复位(「活已经干完了」那一形状返回的是「已补终态」,见 {@link #settleAlreadyDelivered});
+ * false=状态已不是 FAILED/CANCELLED(并发或已重试过)
*/
public boolean retryInPlace(FileTaskEntity task) {
if (task == null || task.getId() == null) {
@@ -74,6 +83,12 @@ public class TaskInPlaceRetryService {
if (handler != null) {
handler.onTaskResumed(task.getId());
}
+ } else if (settleAlreadyDelivered(task)) {
+ // 形状 (b)(BACKLOG B96-08):分片已被上一轮交付清理、直链还挂着 —— 这一单的活其实
+ // 干完了,该补终态并保留文件,而不是排回 PENDING:没有分片可组装、没有行可续跑,
+ // 排回去只能再空转一轮、再等「无人领取」判死一次(33879 就是被点了一次重试、
+ // 2 秒内作业回到 SUCCESS、任务却留在 PENDING)。
+ return true;
}
int attempt = task.getResumeAttempt() == null ? 0 : task.getResumeAttempt();
LocalDateTime now = LocalDateTime.now();
@@ -90,12 +105,13 @@ public class TaskInPlaceRetryService {
log.info("[task-retry] 状态已不是 FAILED/CANCELLED,跳过复位 taskId={}", task.getId());
return false;
}
- if (STATUS_CANCELLED.equals(task.getStatus())) {
- // 中断已交付过部分结果:先清直链再复位作业,顺序反了会出现「作业已 PENDING、
- // 已交付闸还短着」的一轮空转。直链清掉后下载按钮收起,新一轮组装完成再挂新文件。
- clearDeliveredResultUrl(task.getId(), task.getModuleType());
- }
- // 复位「上一代已出过表」的作业:失败代与中断代**都要做**,差别只在直链清不清。
+ // 形状 (a) 与中断代共用这一段:失败代也要清直链(B96-08 第 1 条修法)。
+ // 旧写法只给中断代清、失败代留直链(本意「上一份可能已经可用」),叠上交付闸
+ // 「直链非空即跳过」就成了恒定空转:作业复位后 2 秒又被标回 SUCCESS,新一代永远组装不了。
+ // 代价与中断分支同一口径:清零到新表产出之间用户暂时没有下载入口。
+ // 顺序也不能反:先清直链再复位作业,否则会出现「作业已 PENDING、已交付闸还短着」的一轮空转。
+ clearDeliveredResultUrl(task.getId(), task.getModuleType());
+ // 复位「上一代已出过表」的作业:失败代与中断代**都要做**(B96-08 起两边直链也一起清)。
// 只给中断代做会留下一个永不出表的死循环——那行 SUCCESS 留在原地时,
// enqueueAssembleResult 每次都原样拿回它(底座的 .ne SUCCESS 是刻意的:没人要求重做时
// 不许替换用户可能已下载的成品),于是采集侧把结果全部传完也轮不到出表、心跳停了
@@ -109,6 +125,64 @@ public class TaskInPlaceRetryService {
return true;
}
+ /**
+ * 形状 (b):活已经干完了的失败任务——分片已被上一轮交付清理、结果文件仍挂着——
+ * 重试该做的是补终态,不是重跑。
+ *
+ *
为什么宁可判成功也不排回 PENDING:{@code cleanupResultFileJob} 在交付成功后就把
+ * {@code biz_task_chunk} 与 scope 状态删了(那是分片作为续跑点的寿命终点)。此时复位只会得到
+ * 一个既没有行可组装、也没有分片可续跑的空任务——B96-08 实测 33879 就是这样:复位 → 交付闸
+ * 按「直链非空」跳过组装 → 作业 2 秒回到 SUCCESS → 任务留在 PENDING 等 24 小时判死。
+ * 文件本体还在对象存储、直链仍然可下,所以「收成成功并保留文件」是唯一诚实的结局。
+ *
+ *
CAS 条件仍是 {@code status=FAILED}(并发下与 {@link #retryFailedTask} 的复核同口径);
+ * 抢不到就返回 false 让调用方按「状态已变」处理,不硬写。
+ *
+ * @return true=已补终态(调用方按复位成功返回)
+ */
+ private boolean settleAlreadyDelivered(FileTaskEntity task) {
+ if (!STATUS_FAILED.equals(task.getStatus()) || persistedChunkCount(task.getId(), task.getModuleType()) > 0) {
+ return false;
+ }
+ FileResultEntity result = fileResultMapper.selectOne(new LambdaQueryWrapper()
+ .eq(FileResultEntity::getTaskId, task.getId())
+ .eq(FileResultEntity::getModuleType, task.getModuleType())
+ .orderByAsc(FileResultEntity::getId)
+ .last("limit 1"));
+ String url = result == null ? null : result.getResultFileUrl();
+ if (url == null || url.isBlank()) {
+ return false;
+ }
+ LocalDateTime now = LocalDateTime.now();
+ int updated = fileTaskMapper.update(null, new LambdaUpdateWrapper()
+ .eq(FileTaskEntity::getId, task.getId())
+ .eq(FileTaskEntity::getStatus, STATUS_FAILED)
+ .set(FileTaskEntity::getStatus, STATUS_SUCCESS)
+ .set(FileTaskEntity::getSuccessFileCount, 1)
+ .set(FileTaskEntity::getFailedFileCount, 0)
+ .set(FileTaskEntity::getErrorMessage, null)
+ .set(FileTaskEntity::getFailureCategory, null)
+ .set(FileTaskEntity::getFinishedAt, now)
+ .set(FileTaskEntity::getUpdatedAt, now));
+ if (updated == 0) {
+ log.info("[task-retry] 补终态未生效(状态已变) taskId={}", task.getId());
+ return false;
+ }
+ log.warn("[task-retry] 分片已被上一轮交付清理且结果文件仍挂着,重试补终态而不是重排"
+ + " taskId={} moduleType={} resultId={} 代数={}",
+ task.getId(), task.getModuleType(), result.getId(),
+ task.getResumeAttempt() == null ? 0 : task.getResumeAttempt());
+ return true;
+ }
+
+ /** 已落库的结果分片数:分片在=上一代的续跑点还在,可清直链重采;分片没了=活已经干完了。 */
+ private long persistedChunkCount(Long taskId, String moduleType) {
+ Long count = taskChunkMapper.selectCount(new LambdaQueryWrapper()
+ .eq(TaskChunkEntity::getTaskId, taskId)
+ .eq(TaskChunkEntity::getModuleType, moduleType));
+ return count == null ? 0L : count;
+ }
+
/**
* 通用入口(模块无关):从任务行自身取 moduleType。
*
@@ -142,7 +216,7 @@ public class TaskInPlaceRetryService {
}
}
- /** 结果行只清错误文案:URL 留着(上一份可能已经可用),新文件生成后自然覆盖。 */
+ /** 结果行只清错误文案:直链由 {@link #clearDeliveredResultUrl} 在复位前单独清(B96-08)。 */
private void clearResultError(Long taskId, String moduleType) {
try {
fileResultMapper.update(null, new LambdaUpdateWrapper()
diff --git a/backend-java/src/test/java/com/nanri/aiimage/common/task/StaleTaskDeathReasonTest.java b/backend-java/src/test/java/com/nanri/aiimage/common/task/StaleTaskDeathReasonTest.java
index e6a8d7c10..cdfc1f4f6 100644
--- a/backend-java/src/test/java/com/nanri/aiimage/common/task/StaleTaskDeathReasonTest.java
+++ b/backend-java/src/test/java/com/nanri/aiimage/common/task/StaleTaskDeathReasonTest.java
@@ -82,6 +82,21 @@ class StaleTaskDeathReasonTest {
assertFalse(reason.contains("未回传任何检测结果"), reason);
}
+ /**
+ * B96-08:直链已经挂上的单再说「结果文件未能生成」就是把已交付说成没交付。
+ * 33879 的终态文案正是这个形状——用户据此以为三代重采全白跑(其实表 06:56 就交付过)。
+ */
+ @Test
+ void deliveredResultFileIsNotReportedAsMissing() {
+ String reason = new StaleTaskDeathReason(0L, T, T, "Linux后台抓取: 4000/4000", false, true, true, 30).describe();
+ assertTrue(reason.contains("已上传完全部结果"), reason);
+ assertTrue(reason.contains("结果文件已生成"), reason);
+ assertFalse(reason.contains("未能生成"), reason);
+ // 证据链照旧:分片数虽然被交付清理成 0,心跳与位置仍要写出来
+ assertTrue(reason.contains("最后心跳 10-01 12:34"), reason);
+ assertTrue(reason.contains("最后上报 Linux后台抓取: 4000/4000"), reason);
+ }
+
/**
* 2026-11-10 慧赢2 的 33827:建单后 30 分钟没有任何采集槽位认领(采集机该窗全程无日志),
* 却被写成「无进展」,用户无从判断是自己的数据问题还是排队。零位置文本时补一句成因提示,
diff --git a/backend-java/src/test/java/com/nanri/aiimage/modules/task/service/TaskInPlaceRetryServiceTest.java b/backend-java/src/test/java/com/nanri/aiimage/modules/task/service/TaskInPlaceRetryServiceTest.java
index cafb9a63f..84caa3b71 100644
--- a/backend-java/src/test/java/com/nanri/aiimage/modules/task/service/TaskInPlaceRetryServiceTest.java
+++ b/backend-java/src/test/java/com/nanri/aiimage/modules/task/service/TaskInPlaceRetryServiceTest.java
@@ -1,18 +1,21 @@
package com.nanri.aiimage.modules.task.service;
import com.baomidou.mybatisplus.core.MybatisConfiguration;
+import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;
import com.baomidou.mybatisplus.core.metadata.TableInfoHelper;
import com.nanri.aiimage.common.exception.BusinessException;
import com.nanri.aiimage.modules.task.mapper.FileResultMapper;
import com.nanri.aiimage.modules.task.mapper.FileTaskMapper;
+import com.nanri.aiimage.modules.task.mapper.TaskChunkMapper;
import com.nanri.aiimage.modules.task.mapper.TaskFileJobMapper;
import com.nanri.aiimage.modules.task.model.entity.FileResultEntity;
import com.nanri.aiimage.modules.task.model.entity.FileTaskEntity;
+import com.nanri.aiimage.modules.task.model.entity.TaskChunkEntity;
import com.nanri.aiimage.modules.task.model.entity.TaskFileJobEntity;
import org.apache.ibatis.builder.MapperBuilderAssistant;
import org.junit.jupiter.api.BeforeAll;
import org.junit.jupiter.api.Test;
-import org.springframework.test.util.ReflectionTestUtils;
+import org.mockito.ArgumentCaptor;
import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertFalse;
@@ -46,6 +49,9 @@ class TaskInPlaceRetryServiceTest {
// 「继续」的作业复位走 TaskFileJobEntity 的 lambda 条件更新,同样要注册元数据
TableInfoHelper.initTableInfo(new MapperBuilderAssistant(new MybatisConfiguration(), ""),
TaskFileJobEntity.class);
+ // 形状分档要按 biz_task_chunk 计数(分片还在 / 已被交付清理)
+ TableInfoHelper.initTableInfo(new MapperBuilderAssistant(new MybatisConfiguration(), ""),
+ TaskChunkEntity.class);
}
private static FileTaskEntity failedTask() {
@@ -63,15 +69,21 @@ class TaskInPlaceRetryServiceTest {
TaskFileJobService jobs) {
// 2026-11-03 起「继续」多带两枚依赖:作业 mapper(复位中断已交付的 SUCCESS 作业)
// 与 handler 注册表(清模块补检预算)。失败重试路径不触这两枚,mock 即可。
- return service(mapper, results, jobs, mock(TaskFileJobMapper.class), mock(ResultFileJobHandlerRegistry.class));
+ return service(mapper, results, mock(TaskChunkMapper.class), jobs,
+ mock(TaskFileJobMapper.class), mock(ResultFileJobHandlerRegistry.class));
}
private static TaskInPlaceRetryService service(FileTaskMapper mapper, FileResultMapper results,
TaskFileJobService jobs, TaskFileJobMapper jobMapper,
ResultFileJobHandlerRegistry registry) {
- TaskInPlaceRetryService svc = new TaskInPlaceRetryService(mapper, results, jobs, jobMapper, registry);
- ReflectionTestUtils.setField(svc, "fileTaskMapper", mapper);
- return svc;
+ return service(mapper, results, mock(TaskChunkMapper.class), jobs, jobMapper, registry);
+ }
+
+ private static TaskInPlaceRetryService service(FileTaskMapper mapper, FileResultMapper results,
+ TaskChunkMapper chunks, TaskFileJobService jobs,
+ TaskFileJobMapper jobMapper,
+ ResultFileJobHandlerRegistry registry) {
+ return new TaskInPlaceRetryService(mapper, results, chunks, jobs, jobMapper, registry);
}
@Test
@@ -166,25 +178,101 @@ class TaskInPlaceRetryServiceTest {
void 失败任务重试也要复位上一代已交付的出表作业() {
FileTaskMapper mapper = mock(FileTaskMapper.class);
FileResultMapper results = mock(FileResultMapper.class);
+ TaskChunkMapper chunks = mock(TaskChunkMapper.class);
TaskFileJobService jobs = mock(TaskFileJobService.class);
TaskFileJobMapper jobMapper = mock(TaskFileJobMapper.class);
when(mapper.update(isNull(), any())).thenReturn(1);
+ when(chunks.selectCount(any())).thenReturn(364L);
FileResultEntity result = new FileResultEntity();
result.setId(36758L);
when(results.selectOne(any())).thenReturn(result);
when(jobMapper.selectOne(any())).thenReturn(deliveredJob());
- boolean ok = service(mapper, results, jobs, jobMapper,
+ boolean ok = service(mapper, results, chunks, jobs, jobMapper,
mock(ResultFileJobHandlerRegistry.class)).retryInPlace(failedTask());
assertTrue(ok);
// 已交付作业被复位成 PENDING(下一轮才排得上出表)
verify(jobMapper).update(isNull(), any());
- // 失败保留直链:只清旧错误文案,不清下载直链(用户手上那份还能下)
- verify(results, times(1)).update(isNull(), any());
+ // 结果行两次 update:清上一代直链(让位给新表)+清旧错误文案。旧写法这里只清错误文案、
+ // 直链留着「因为上一份可能已经可用」,正是 B96-08 让三代重采全白干的那一格。
+ verify(results, times(2)).update(isNull(), any());
verify(jobs).resetTerminalFailedForRecovery(eq(32967L), eq("APPEARANCE_PATENT"), eq(36758L));
}
+ /**
+ * 形状 (a):分片还在(33880 364 行、33898 275 行)。FAILED 分支必须与 CANCELLED 同口径清直链——
+ * 不清则复位后的作业被交付闸「直链非空即跳过」在 2 秒内标回 SUCCESS,新一代永远组装不了。
+ *
+ * 顺序也是判据:直链必须先清、作业才能复位成 PENDING。反过来的话,worker 在两步之间
+ * 领到作业,看到的仍是上一代的直链,于是照旧被交付闸短路——空转一秒不差地重演一遍。
+ * 交付闸本身刻意保持「只认直链」(31527 那 45 秒五次空表就靠它挡着),所以这条顺序是唯一的解。
+ */
+ @Test
+ void 失败任务重试必须清掉上一代直链_否则新一代永远组装不了() {
+ FileTaskMapper mapper = mock(FileTaskMapper.class);
+ FileResultMapper results = mock(FileResultMapper.class);
+ TaskChunkMapper chunks = mock(TaskChunkMapper.class);
+ TaskFileJobService jobs = mock(TaskFileJobService.class);
+ TaskFileJobMapper jobMapper = mock(TaskFileJobMapper.class);
+ when(mapper.update(isNull(), any())).thenReturn(1);
+ when(chunks.selectCount(any())).thenReturn(364L);
+ FileResultEntity result = new FileResultEntity();
+ result.setId(36809L);
+ result.setResultFileUrl("appearance-patent/2026/11/33879-result.xlsx");
+ when(results.selectOne(any())).thenReturn(result);
+ when(jobMapper.selectOne(any())).thenReturn(deliveredJob());
+
+ boolean ok = service(mapper, results, chunks, jobs, jobMapper,
+ mock(ResultFileJobHandlerRegistry.class)).retryInPlace(failedTask());
+
+ assertTrue(ok);
+ ArgumentCaptor captor = ArgumentCaptor.forClass(LambdaUpdateWrapper.class);
+ verify(results, times(2)).update(isNull(), captor.capture());
+ assertTrue(captor.getAllValues().stream()
+ .anyMatch(wrapper -> String.valueOf(wrapper.getSqlSet()).contains("result_file_url")),
+ "清直链那一次更新必须真的发生:只有清错误文案的话,交付闸仍会短路");
+ // 顺序:清直链(结果行 update,第一次)必须早于作业复位(作业行 update)
+ org.mockito.InOrder order = org.mockito.Mockito.inOrder(results, jobMapper);
+ order.verify(results).update(isNull(), any());
+ order.verify(jobMapper).update(isNull(), any());
+ }
+
+ /**
+ * 形状 (b):分片已被上一轮交付清理、直链还挂着(33879)。这一单的活其实干完了,
+ * 重试该「补终态 + 保留文件」,不是排回 PENDING 再空转一轮(B96-08 第 2 条修法)。
+ */
+ @Test
+ void 分片已被交付清理且直链还挂着时重试补终态而不是重排() {
+ FileTaskMapper mapper = mock(FileTaskMapper.class);
+ FileResultMapper results = mock(FileResultMapper.class);
+ TaskChunkMapper chunks = mock(TaskChunkMapper.class);
+ TaskFileJobService jobs = mock(TaskFileJobService.class);
+ TaskFileJobMapper jobMapper = mock(TaskFileJobMapper.class);
+ when(mapper.update(isNull(), any())).thenReturn(1);
+ when(chunks.selectCount(any())).thenReturn(0L);
+ FileResultEntity result = new FileResultEntity();
+ result.setId(36809L);
+ result.setResultFileUrl("appearance-patent/2026/11/33879-result.xlsx");
+ when(results.selectOne(any())).thenReturn(result);
+
+ boolean ok = service(mapper, results, chunks, jobs, jobMapper,
+ mock(ResultFileJobHandlerRegistry.class)).retryInPlace(failedTask());
+
+ assertTrue(ok);
+ ArgumentCaptor captor = ArgumentCaptor.forClass(LambdaUpdateWrapper.class);
+ verify(mapper, times(1)).update(isNull(), captor.capture());
+ LambdaUpdateWrapper wrapper = captor.getValue();
+ assertTrue(String.valueOf(wrapper.getSqlSet()).contains("status="), "必须落任务状态");
+ assertTrue(wrapper.getParamNameValuePairs().containsValue("SUCCESS"),
+ "补终态=收成成功(文件保留),不是排回 PENDING");
+ // 代数不推进、作业与结果行一概不动:这一单没有第二代要跑
+ assertFalse(String.valueOf(wrapper.getSqlSet()).contains("resume_attempt"), "补终态不是重跑,代数不该 +1");
+ verify(jobMapper, never()).update(isNull(), any());
+ verify(results, never()).update(isNull(), any());
+ verify(jobs, never()).resetTerminalFailedForRecovery(anyLong(), any(), anyLong());
+ }
+
@Test
void 失败任务没有已交付作业时不动物业行() {
FileTaskMapper mapper = mock(FileTaskMapper.class);