diff --git a/backend-java/src/main/java/com/nanri/aiimage/common/retry/LlmBalanceGuard.java b/backend-java/src/main/java/com/nanri/aiimage/common/retry/LlmBalanceGuard.java index 4fb9af4bc..a42bed790 100644 --- a/backend-java/src/main/java/com/nanri/aiimage/common/retry/LlmBalanceGuard.java +++ b/backend-java/src/main/java/com/nanri/aiimage/common/retry/LlmBalanceGuard.java @@ -18,6 +18,18 @@ public final class LlmBalanceGuard { /** 行级/任务级统一归因文案:说清是上游账户欠费,不是这行数据的问题。 */ public static final String REASON_LLM_BALANCE_DUE = "LLM 服务余额欠费(上游账户额度不足,非本行数据问题)"; + /** + * 任务级终态文案(2026-10-27 用户口径:「提示语要纠正一下,不能误导用户」)。 + * + *
欠费与密钥失效都是外部条件坏了:既不能写成「请稍后重试」(把欠费说成临时抖动,
+ * 用户会干等),也不能让人以为是自己那张表格的问题。这里只说三件事——
+ * 谁的问题(上游账户/密钥)、已经做了什么(任务终止、停止继续消耗采集出口)、
+ * 下一步做什么(充值或换密钥后重新发起)。
+ */
+ public static final String TASK_TERMINAL_GUIDANCE =
+ "任务已终止:上游 LLM 账户欠费或密钥失效,不是你本次上传表格的数据问题;"
+ + "已停止后续检测与采集,以免继续消耗代理出口额度。请充值或更换有效密钥后重新发起检测。";
+
private static final String[] MARKERS = {
"insufficient_user_quota",
"insufficient_quota",
diff --git a/backend-java/src/main/java/com/nanri/aiimage/modules/appearancepatent/service/AppearancePatentTaskService.java b/backend-java/src/main/java/com/nanri/aiimage/modules/appearancepatent/service/AppearancePatentTaskService.java
index c6b914b81..af993aa6d 100644
--- a/backend-java/src/main/java/com/nanri/aiimage/modules/appearancepatent/service/AppearancePatentTaskService.java
+++ b/backend-java/src/main/java/com/nanri/aiimage/modules/appearancepatent/service/AppearancePatentTaskService.java
@@ -367,7 +367,18 @@ public class AppearancePatentTaskService extends AbstractFileTaskPipeline 调用点是作业执行线程(LLM 批次就在这里跑),不是心跳线程——铁律 8 不许在心跳里判死。
+ */
+ @FunctionalInterface
+ public interface FatalLlmFailureHandler {
+ void onFatalLlmFailure(FileTaskEntity task, String failureMessage);
+ }
+
private final AppearancePatentProperties properties;
private final AppearancePatentLlmClient llmClient;
private final AppearancePatentTaskCacheService taskCacheService;
@@ -71,6 +83,7 @@ public class AppearancePatentLlmBatchPipeline {
private final Function 刻意只取 {@code BALANCE}:连接不可达({@code SERVICE_DOWN})、429 限流、5xx 抖动、
+ * 抓取缺口都属「外部会自己恢复或补传能救」,判宽了就是拿用户的任务给一次网络抖动陪葬。
+ */
+ static boolean isFatalLlmArrearsFailure(String errorMessage) {
+ return TaskRetryEligibility.forceMajeureCategory(errorMessage) == TaskRetryEligibility.Category.BALANCE;
+ }
+
+ /**
+ * 上游余额欠费/密钥失效 → 任务立即落终态 FAILED。
+ *
+ * 为什么必须由 Java 侧落终态(2026-10-27 现网):{@code f3445c21} 只做到「行级不再重试三次、
+ * 归因写对」,任务本身仍停在 RUNNING/WAIT_LLM 等 Python 继续回传分片。采集端
+ * ({@code maixiang ap_worker})只看 {@code /task/heartbeat} 的 {@code alive},看不到终态就会
+ * 继续为剩下的行按次付费买出口 IP——而那些行永远进不了 LLM,钱白花。
+ * 任务一终态,{@code TaskHeartbeatService} 对其返回 {@code alive=false}(既有行为),worker 下一跳收手。
+ *
+ * 判定发生在作业执行线程(LLM 批次就在这里跑),不在心跳线程(铁律 8)。
+ * 写之前重读一次库里的现状态:已 SUCCESS/COMPLETED/CANCELLED/FAILED 的一律不动(铁律 14),
+ * 本方法因此可重入,停放期间同一任务被多个入口命中欠费也只写一次。
+ */
+ public void terminalizeOnFatalLlmFailure(FileTaskEntity task, String failureMessage) {
+ if (task == null || task.getId() == null) {
+ return;
+ }
+ if (!isFatalLlmArrearsFailure(failureMessage)) {
+ // 兜底闸:调用方判宽了也不许把可恢复的失败写成终态
+ return;
+ }
+ FileTaskEntity current = fileTaskMapper.selectById(task.getId());
+ String currentStatus = current != null ? current.getStatus() : task.getStatus();
+ if (TaskStatuses.FileTask.TERMINAL.contains(currentStatus)) {
+ log.info("[appearance-patent] 任务已是终态,欠费归因不改写状态 taskId={} status={}",
+ task.getId(), currentStatus);
+ return;
+ }
+ String terminalMessage = fatalLlmTerminalMessage(failureMessage);
+ task.setStatus(STATUS_FAILED);
+ task.setSuccessFileCount(0);
+ task.setFailedFileCount(1);
+ task.setErrorMessage(terminalMessage);
+ task.setUpdatedAt(LocalDateTime.now());
+ task.setFinishedAt(LocalDateTime.now());
+ fileTaskMapper.updateById(task);
+ taskCacheService.deleteTaskCache(task.getId());
+ log.warn("[appearance-patent] LLM 上游欠费/密钥失效,任务落终态 FAILED 以停止为空转的行继续买出口 IP"
+ + " taskId={} err={}", task.getId(), terminalMessage);
+ }
+
+ /**
+ * 终态文案 = 生产者原文(客户端的欠费归因 + 上游 lastErr)+ 可执行动作,
+ * 原文一个字都不在这里重写;文案里没有「稍后重试」,欠费不会被说成抖动。
+ */
+ static String fatalLlmTerminalMessage(String failureMessage) {
+ String raw = failureMessage == null ? "" : failureMessage.trim();
+ return raw.isEmpty()
+ ? LlmBalanceGuard.TASK_TERMINAL_GUIDANCE
+ : raw + ";" + LlmBalanceGuard.TASK_TERMINAL_GUIDANCE;
+ }
+
public FileResultEntity findOrCreateResultRecordForAssembly(FileTaskEntity task, int rowCount) {
if (task == null || task.getId() == null) {
return null;
diff --git a/backend-java/src/test/java/com/nanri/aiimage/modules/appearancepatent/service/AppearancePatentCandidateCollectionFaultToleranceTest.java b/backend-java/src/test/java/com/nanri/aiimage/modules/appearancepatent/service/AppearancePatentCandidateCollectionFaultToleranceTest.java
index 7734c5264..461ba1634 100644
--- a/backend-java/src/test/java/com/nanri/aiimage/modules/appearancepatent/service/AppearancePatentCandidateCollectionFaultToleranceTest.java
+++ b/backend-java/src/test/java/com/nanri/aiimage/modules/appearancepatent/service/AppearancePatentCandidateCollectionFaultToleranceTest.java
@@ -180,7 +180,11 @@ class AppearancePatentCandidateCollectionFaultToleranceTest {
task -> "prompt",
task -> "sk-test",
(taskId, scopeHash, chunkIndex, rows) -> List.of(),
- (preferred, fallback) -> preferred == null || preferred.isBlank() ? fallback : preferred);
+ (preferred, fallback) -> preferred == null || preferred.isBlank() ? fallback : preferred,
+ // 本夹具只驱动「候选收集」,永远不会进欠费终态分支;真进来了就说明测试形状变了
+ (fatalTask, failureMessage) -> {
+ throw new IllegalStateException("unexpected fatal llm failure: " + failureMessage);
+ });
}
private Set 为什么这是独立的一笔(而不是 B46 已经做完的那半):{@code f3445c21} 只让行级调用「一次就停、
+ * 归因写对」,任务本身还停在 RUNNING/WAIT_LLM 等 Python 继续回传分片。采集端只看
+ * {@code /task/heartbeat} 的 {@code alive},看不到终态就会继续为剩下的行按次付费买出口 IP,
+ * 而那些行永远进不了 LLM。任务变终态 → 心跳 {@code alive=false} → worker 下一跳收手。
+ *
+ * 反向半边同样重要:连接不可达 / 5xx / 429 / 抓取缺口都必须照旧继续,
+ * 判宽了就是拿用户的整单去给一次网络抖动陪葬。
+ *
+ * 夹具走 {@code service.submitLlmBatches} 这条生产接线(批管线 → 欠费处置回调 →
+ * 结果作业支撑 → FileTaskMapper),不手工 new 二十几个参数,以免测的是一套生产里不存在的 wiring。
+ * 异常原文一律用外部世界的字符串或本仓常量的引用,不手抄文案。
+ */
+@ExtendWith(MockitoExtension.class)
+class AppearancePatentLlmArrearsTerminalTest {
+
+ private static final Long TASK_ID = 32901L;
+ private static final Long JOB_ID = 24110L;
+ private static final String SCOPE_HASH = "scope-hash-1";
+ private static final int CHUNK_INDEX = 1;
+ private static final String POINTER = "ptr-chunk-1.json";
+ /** 两行都还没有结论 ⇒ batchSize=1 时正好两批:第二批发不发,就是「烧不烧出口」的分界。 */
+ private static final String UNRESOLVED_ROWS =
+ "[{\"rowToken\":\"r1\",\"asin\":\"B0A0000001\",\"title\":\"RUNNING SHOE\",\"url\":\"http://img/1.jpg\",\"groupKey\":\"g1\"},"
+ + "{\"rowToken\":\"r2\",\"asin\":\"B0A0000002\",\"title\":\"COTTON BAG\",\"url\":\"http://img/2.jpg\",\"groupKey\":\"g2\"}]";
+ /** 上游 403 原文(现网形状)。这是外部世界的字符串,不是本仓文案,抄它不算抄自家字面量。 */
+ private static final String QUOTA_403_BODY = "{\"error\":{\"message\":\"预扣费额度失败, 用户[151246]剩余额度: "
+ + "฿0.029168, 需要预扣费额度: ฿0.032402\",\"type\":\"new_api_error\",\"code\":\"insufficient_user_quota\"}}";
+
+ @Mock private LocalFileStorageService localFileStorageService;
+ @Mock private OssStorageService ossStorageService;
+ @Mock private ResultDownloadResolver resultDownloadResolver;
+ @Mock private StorageProperties storageProperties;
+ @Mock private FileTaskMapper fileTaskMapper;
+ @Mock private FileResultMapper fileResultMapper;
+ @Mock private TaskScopeStateMapper taskScopeStateMapper;
+ @Mock private TaskChunkMapper taskChunkMapper;
+ @Spy private ObjectMapper objectMapper = new ObjectMapper();
+ @Mock private AppearancePatentLlmClient llmClient;
+ @Mock private AppearancePatentTaskCacheService taskCacheService;
+ @Mock private AppearancePatentProperties properties;
+ @Mock private TaskFileJobService taskFileJobService;
+ @Mock private TaskProgressSnapshotService taskProgressSnapshotService;
+ @Mock private TaskHeartbeatPositionService taskHeartbeatPositionService;
+ @Mock private TransientPayloadStorageService transientPayloadStorageService;
+ @Mock private PlatformTransactionManager transactionManager;
+ @Mock private DistributedJobLockService distributedJobLockService;
+ @Mock private TaskDistributedLockService taskDistributedLockService;
+ @Mock private InstanceMetadata instanceMetadata;
+ @Mock private TaskProgressLightAssembler taskProgressLightAssembler;
+ @Mock private UserApiSecretService userApiSecretService;
+
+ @InjectMocks private AppearancePatentTaskService service;
+
+ @BeforeAll
+ static void initializeMybatisMetadata() {
+ MapperBuilderAssistant assistant = new MapperBuilderAssistant(new MybatisConfiguration(), "");
+ TableInfoHelper.initTableInfo(assistant, FileTaskEntity.class);
+ TableInfoHelper.initTableInfo(assistant, FileResultEntity.class);
+ TableInfoHelper.initTableInfo(assistant, TaskChunkEntity.class);
+ TableInfoHelper.initTableInfo(assistant, TaskScopeStateEntity.class);
+ }
+
+ @BeforeEach
+ void setUp() {
+ lenient().when(properties.getLlmBatchSize()).thenReturn(1);
+ lenient().when(transientPayloadStorageService.isSharedWriteEnabled()).thenReturn(true);
+ lenient().when(transientPayloadStorageService.resolvePayload(eq(POINTER), anyString())).thenReturn(UNRESOLVED_ROWS);
+ lenient().when(transientPayloadStorageService.storeChunkPayloadVersioned(
+ anyString(), anyLong(), anyString(), any(), anyString())).thenReturn("sibling-1");
+ lenient().when(taskChunkMapper.selectById(anyLong())).thenReturn(chunk());
+ lenient().when(taskChunkMapper.update(any(), any())).thenReturn(1);
+ lenient().when(userApiSecretService.findPlainValue(any(), anyString())).thenReturn("");
+ }
+
+ // ===== (a) 欠费 → 作业路径把任务落成终态,并带上正确文案 =====
+
+ /**
+ * 上游 403 欠费原文进作业路径:任务必须立刻 FAILED+写明动作,且第二批不再发出
+ * (发一次就多扣一次用户 LLM 次数,而结论永远拿不到)。
+ */
+ @Test
+ void upstreamQuotaFailureTerminalizesTaskAndStopsRemainingBatches() throws Exception {
+ FileTaskEntity task = submitFailingWith(new IllegalStateException(QUOTA_403_BODY));
+
+ FileTaskEntity written = capturedTerminalWrite();
+ assertEquals(TASK_ID, written.getId());
+ assertEquals(TaskStatuses.FileTask.FAILED, written.getStatus(), "欠费必须把任务落 FAILED,不许停在 RUNNING/WAIT_LLM");
+ assertNotNull(written.getFinishedAt(), "终态必须带 finished_at,否则读侧仍按在跑展示");
+ assertEquals(0, written.getSuccessFileCount());
+ assertEquals(1, written.getFailedFileCount());
+ // 生产者原文一个字都没被重写
+ assertTrue(written.getErrorMessage().contains(QUOTA_403_BODY), "实际: " + written.getErrorMessage());
+ // 可执行动作(充值/换密钥后重发)由本仓文案给出
+ assertTrue(written.getErrorMessage().contains(LlmBalanceGuard.TASK_TERMINAL_GUIDANCE),
+ "实际: " + written.getErrorMessage());
+ assertEquals(TaskStatuses.FileTask.FAILED, task.getStatus(), "内存实体也要同步:宿主随后据此决定不再停放");
+ verify(llmClient, times(1)).inspectRows(any(), any(), any());
+ }
+
+ /** 客户端把欠费包成 {@code REASON_LLM_BALANCE_DUE + lastErr} 那一层,同样必须落终态。 */
+ @Test
+ void clientWrappedBalanceReasonAlsoTerminalizesTask() throws Exception {
+ String producerMessage = LlmBalanceGuard.REASON_LLM_BALANCE_DUE + ";lastErr=" + QUOTA_403_BODY;
+
+ submitFailingWith(new IllegalStateException(producerMessage, new IllegalStateException(QUOTA_403_BODY)));
+
+ FileTaskEntity written = capturedTerminalWrite();
+ assertEquals(TaskStatuses.FileTask.FAILED, written.getStatus());
+ assertTrue(written.getErrorMessage().contains(LlmBalanceGuard.REASON_LLM_BALANCE_DUE),
+ "实际: " + written.getErrorMessage());
+ assertTrue(written.getErrorMessage().contains(QUOTA_403_BODY), "实际: " + written.getErrorMessage());
+ verify(llmClient, times(1)).inspectRows(any(), any(), any());
+ }
+
+ /**
+ * 密钥失效({@code TaskRetryEligibility} 的 KEY_MARKERS 一族)与欠费同属「不修外部条件、
+ * 重跑必然同结果」,也要落终态;这条钉住判据取的是 BALANCE 类而不是只认欠费字样。
+ */
+ @Test
+ void invalidLlmKeyTerminalizesTaskToo() throws Exception {
+ submitFailingWith(new IllegalStateException("LLM http 401: invalid api key"));
+
+ assertEquals(TaskStatuses.FileTask.FAILED, capturedTerminalWrite().getStatus());
+ }
+
+ /**
+ * 提示语不许误导用户:终态文案里不能出现「请稍后重试」这类把欠费说成临时抖动的话,
+ * 必须写明充值/换密钥这个动作。文案取自真实落库的那一条,不是测试自己拼的。
+ */
+ @Test
+ void terminalCopyPointsAtTheRealCauseAndAnActionNotAtATransientBlip() throws Exception {
+ submitFailingWith(new IllegalStateException(QUOTA_403_BODY));
+
+ String copy = capturedTerminalWrite().getErrorMessage();
+ assertFalse(copy.contains("稍后重试"), "欠费被写成抖动: " + copy);
+ assertFalse(copy.contains("无需修改"), "欠费被写成表格问题: " + copy);
+ assertTrue(copy.contains("充值"), "实际: " + copy);
+ assertTrue(copy.contains("密钥"), "实际: " + copy);
+ assertTrue(copy.contains("任务已终止"), "实际: " + copy);
+ }
+
+ // ===== (b) 其他失败原因一律继续:不许误杀成终态 =====
+
+ /** 连上了只是这一轮 5xx:连接层与上游都会自己恢复,任务照旧停放,剩下的批次照旧跑。 */
+ @Test
+ void gatewayFiveOhKeepsTaskRunningAndStillRunsEveryBatch() throws Exception {
+ FileTaskEntity task = submitFailingWith(new IllegalStateException("LLM http 502: Bad Gateway"));
+
+ verify(fileTaskMapper, never()).updateById(any(FileTaskEntity.class));
+ assertEquals(TaskStatuses.FileTask.RUNNING, task.getStatus());
+ assertNull(task.getFinishedAt());
+ verify(llmClient, times(2)).inspectRows(any(), any(), any());
+ }
+
+ /** 429 限流不是欠费({@code LlmBalanceGuardTest} 已钉过识别侧),这里钉任务侧同样不动。 */
+ @Test
+ void rateLimitedBatchesKeepTaskRunning() throws Exception {
+ FileTaskEntity task = submitFailingWith(new IllegalStateException("LLM http 429: Too Many Requests"));
+
+ verify(fileTaskMapper, never()).updateById(any(FileTaskEntity.class));
+ assertEquals(TaskStatuses.FileTask.RUNNING, task.getStatus());
+ assertNull(task.getFinishedAt());
+ verify(llmClient, times(2)).inspectRows(any(), any(), any());
+ }
+
+ /** 连接根本没建立(不可达一族):归 SERVICE_DOWN,属「等服务恢复」,不是判死的理由。 */
+ @Test
+ void connectFailureKeepsTaskRunningAndIsNotMistakenForArrears() throws Exception {
+ FileTaskEntity task = submitFailingWith(new IllegalStateException("Connection refused"));
+
+ verify(fileTaskMapper, never()).updateById(any(FileTaskEntity.class));
+ assertEquals(TaskStatuses.FileTask.RUNNING, task.getStatus());
+ verify(llmClient, times(2)).inspectRows(any(), any(), any());
+ }
+
+ /**
+ * 抓取缺口(交付侧的「有 N 行未完成检测」)原文由真实生产者 {@code appendDeliveryGapMessage}
+ * 生成后灌进这条路径:它是可带缺口交付的部分失败,绝不能被当成欠费判死。
+ */
+ @Test
+ @SuppressWarnings("unchecked")
+ void deliveryGapCopyIsNotMistakenForArrears() throws Exception {
+ Object deliverySupport = ReflectionTestUtils.invokeMethod(service, "deliverySupport");
+ String gapCopy = (String) ReflectionTestUtils.invokeMethod(deliverySupport, "appendDeliveryGapMessage",
+ null, new AppearancePatentRowOutcome.Facts(5, 3, 0, List.of("B0A0000001", "B0A0000002")));
+ assertTrue(gapCopy.contains("未完成检测"), "夹具应当是缺口文案,实际: " + gapCopy);
+
+ FileTaskEntity task = submitFailingWith(new IllegalStateException(gapCopy));
+
+ verify(fileTaskMapper, never()).updateById(any(FileTaskEntity.class));
+ assertEquals(TaskStatuses.FileTask.RUNNING, task.getStatus());
+ }
+
+ // ===== (c) 已是终态的任务不被改写(铁律 14) =====
+
+ @Test
+ void successfulTaskIsNeverRewrittenToFailedByArrears() throws Exception {
+ assertTerminalStatusUntouchedByArrears(TaskStatuses.FileTask.SUCCESS);
+ }
+
+ @Test
+ void cancelledTaskIsNeverRewrittenToFailedByArrears() throws Exception {
+ assertTerminalStatusUntouchedByArrears(TaskStatuses.FileTask.CANCELLED);
+ }
+
+ /** 已经终态(含上一跳刚被欠费判死):重入只许挡回去,不许第二次写库。 */
+ @Test
+ void alreadyFailedTaskIsNotWrittenAgain() throws Exception {
+ assertTerminalStatusUntouchedByArrears(TaskStatuses.FileTask.FAILED);
+ }
+
+ // ===== (d) 终态之后心跳的 alive 语义(worker 收手的依据) =====
+
+ /**
+ * 欠费文案灌进既有收尾 {@code finalizeTask} 时必须落 FAILED,不能被
+ * 「可带缺口交付」的抓取缺口判定救回 SUCCESS——这条是对 {@code isPartialDataGapError}
+ * 那段既有语义的实证,不是照抄它的注释。
+ */
+ @Test
+ void arrearsCopyIsNotSalvagedAsAPartialDataGapByFinalizeTask() throws Exception {
+ submitFailingWith(new IllegalStateException(QUOTA_403_BODY));
+ String terminalCopy = capturedTerminalWrite().getErrorMessage();
+ when(fileResultMapper.selectList(any())).thenReturn(List.of());
+
+ AppearancePatentResultJobSupport support =
+ ReflectionTestUtils.invokeMethod(service, "resultJobSupport");
+ FileTaskEntity another = taskWithStatus(TaskStatuses.FileTask.RUNNING);
+ support.finalizeTask(another, terminalCopy, 0, true);
+
+ assertEquals(TaskStatuses.FileTask.FAILED, another.getStatus(),
+ "欠费文案被当成可带缺口交付的抓取缺口了: " + another.getErrorMessage());
+ assertTrue(another.getErrorMessage().contains(terminalCopy), "实际: " + another.getErrorMessage());
+ }
+
+ // ===== 辅助 =====
+
+ /** 用给定异常打爆 LLM 批次;返回宿主手里的那枚任务实体。 */
+ private FileTaskEntity submitFailingWith(Throwable failure) throws Exception {
+ FileTaskEntity task = taskWithStatus(TaskStatuses.FileTask.RUNNING);
+ when(taskCacheService.beginRowInspection(eq(TASK_ID), anyString())).thenReturn(true);
+ when(llmClient.inspectRows(any(), any(), any())).thenThrow(failure);
+ when(llmClient.markRowsFailed(any(), anyString())).thenReturn(rows(UNRESOLVED_ROWS));
+
+ ReflectionTestUtils.invokeMethod(service, "submitLlmBatches",
+ task, new FileResultEntity(), job(), List.of(chunk()));
+ return task;
+ }
+
+ private FileTaskEntity capturedTerminalWrite() {
+ ArgumentCaptor 本类不改 {@link TaskHeartbeatService},只按 {@code TaskHeartbeatServiceTest} 的夹具风格钉
+ * 「外观专利任务被欠费判成 FAILED 之后」这一格读数,并留一枚 RUNNING 对照,防止整条断言
+ * 因为桩没接上而变成恒 false 的假绿。
+ */
+class AppearancePatentArrearsHeartbeatAliveTest {
+
+ private static final Long TASK_ID = 32901L;
+ /** 上游 403 原文(外部世界的字符串)+ 本仓归因常量的引用,不手抄自家文案。 */
+ private static final String QUOTA_403_BODY = "{\"error\":{\"code\":\"insufficient_user_quota\","
+ + "\"message\":\"预扣费额度失败, 用户[151246]剩余额度: ฿0.029168\"}}";
+ private static final String ARREARS_COPY =
+ LlmBalanceGuard.REASON_LLM_BALANCE_DUE + ";lastErr=" + QUOTA_403_BODY;
+
+ private final FileTaskMapper fileTaskMapper = mock(FileTaskMapper.class);
+ private final TaskProgressSnapshotService taskProgressSnapshotService = mock(TaskProgressSnapshotService.class);
+ private final BrandTaskHeartbeatSpi brandTaskHeartbeatSpi = mock(BrandTaskHeartbeatSpi.class);
+ private final TaskHeartbeatLivenessService livenessService = mock(TaskHeartbeatLivenessService.class);
+
+ @BeforeAll
+ static void initializeMybatisMetadata() {
+ TableInfoHelper.initTableInfo(
+ new MapperBuilderAssistant(new MybatisConfiguration(), ""),
+ FileTaskEntity.class);
+ }
+
+ private TaskHeartbeatService service() {
+ return new TaskHeartbeatService(fileTaskMapper, taskProgressSnapshotService, brandTaskHeartbeatSpi,
+ livenessService, List.of(new AppearancePatentTaskHeartbeatSpi(
+ mock(AppearancePatentTaskCacheService.class),
+ mock(TaskFileJobService.class),
+ new AppearancePatentProperties())));
+ }
+
+ @Test
+ @SuppressWarnings("unchecked")
+ void arrearsFailedTaskHeartbeatSaysNotAlive() {
+ FileTaskEntity task = apTask("FAILED");
+ task.setErrorMessage(ARREARS_COPY);
+ when(fileTaskMapper.selectOne(any(LambdaQueryWrapper.class))).thenReturn(task);
+
+ TaskHeartbeatVo result = service().heartbeat(TASK_ID, new TaskHeartbeatRequest());
+
+ assertFalse(result.isAlive(), "任务已终态还回 alive=true,采集端就会继续烧出口 IP");
+ assertEquals("FAILED", result.getStatus());
+ assertEquals("APPEARANCE_PATENT", result.getModuleType());
+ // 非在跑任务不许再刷 updated_at(刷了就等于把它重新写成"还活着")
+ verify(fileTaskMapper, never()).update(isNull(), any(LambdaUpdateWrapper.class));
+ }
+
+ /** 对照组:同一枚任务还是 RUNNING 时心跳照旧 alive=true,证明上一条的 false 是真判出来的。 */
+ @Test
+ @SuppressWarnings("unchecked")
+ void runningTaskHeartbeatStillSaysAlive() {
+ FileTaskEntity task = apTask("RUNNING");
+ when(fileTaskMapper.selectOne(any(LambdaQueryWrapper.class))).thenReturn(task);
+ when(fileTaskMapper.update(isNull(), any(LambdaUpdateWrapper.class))).thenReturn(1);
+
+ TaskHeartbeatVo result = service().heartbeat(TASK_ID, new TaskHeartbeatRequest());
+
+ assertTrue(result.isAlive());
+ assertEquals("RUNNING", result.getStatus());
+ }
+
+ private FileTaskEntity apTask(String status) {
+ FileTaskEntity task = new FileTaskEntity();
+ task.setId(TASK_ID);
+ task.setModuleType("APPEARANCE_PATENT");
+ task.setUserId(7L);
+ task.setStatus(status);
+ return task;
+ }
+}