fix(similar-asin): history 保留续跑件并补回窗口外非终态任务,更新打断后不再两头看不见

现场(用户 2026-10-22「更新客户端,在跑的任务列表没掉」):
① 客户端更新打断任务后,V129 自动续跑会克隆一条新的 PENDING
(TaskRetryCloneSupport:status=PENDING + resume_of_task_id 指向原件)。原件已 FAILED
沉进历史,而 SimilarAsinHistoryAssembler 对 PENDING 一律 continue ⇒「当前任务」和
「历史任务」两头都看不到,要等下一个在线客户端把它领走才重新出现。
② 第二条独立成因:history 由结果行驱动、ORDER BY created_at DESC LIMIT 50..100
(每任务一行)。一个还在跑、但结果行被更新任务挤出窗口的任务会从列表里彻底消失;
前端「当前任务」唯一的兜底是内存 liveProgressItems,页面重载/客户端更新即清零。

改法:
① PENDING 只跳过「未启动的解析预览」,续跑克隆件保留(普通预览不进列表,避免用户
   没打算跑的预览一直挂在当前任务里);
② history 追加一次固定的非终态任务查询(RUNNING + 续跑件),把窗口外的按任务头补回
   列表最前;resultId/downloadUrl 留空、由前端按 taskStatus 渲染(删除按钮本就
   v-if="itemSource(item).resultId",不会拿 null 打接口)。
查询数仍是常数:1 次结果行 + 2 次任务 + 1 次 job = 4(性能守卫同步改成 ≤2 / 总数 ≤4)。

门禁:mvn -o test-compile rc=0;整量 4695 例 / 0 红 / 0 错 / 17 skip / BUILD SUCCESS
(07:05);组装器 15 例、history 批次 13 例、性能守卫 8 例全绿(新增 4 例:续跑件保
留、普通预览仍跳过、窗口外补回、窗口内不重复)。
This commit is contained in:
2026-10-22 20:55:57 +08:00
parent 58c40b6695
commit 3766a34360
5 changed files with 169 additions and 9 deletions
@@ -45,6 +45,7 @@ import java.util.Map;
import java.util.concurrent.atomic.AtomicInteger;
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.assertNull;
import static org.junit.jupiter.api.Assertions.assertTrue;
@@ -161,6 +162,26 @@ class SimilarAsinTaskServiceHistoryBatchTest {
LambdaQueryWrapper<FileTaskEntity> q = invocation.getArgument(0);
String segment = q.getSqlSegment() == null ? "" : q.getSqlSegment();
List<Object> params = paramValuesOf(q, segment);
// 非终态任务查询(history 补回窗口外的在跑任务):按 status 条件过滤任务表。
// MyBatis-Plus 3.5.7 把 IN 展开成逐值占位符,所以字符串参数要两个分支一起收。
if (segment.contains("status")) {
List<String> wantedStatuses = new ArrayList<>();
for (Object value : params) {
if (value instanceof List<?> list) {
for (Object item : list) {
if (item instanceof String status) {
wantedStatuses.add(status);
}
}
} else if (value instanceof String status) {
wantedStatuses.add(status);
}
}
return taskDb.stream()
.filter(t -> wantedStatuses.contains(t.getStatus()))
.filter(t -> MODULE.equals(t.getModuleType()))
.toList();
}
List<Long> wanted = new ArrayList<>();
for (Object value : params) {
if (value instanceof List<?> list) {
@@ -306,6 +327,46 @@ class SimilarAsinTaskServiceHistoryBatchTest {
vo.getItems().stream().map(SimilarAsinHistoryItemVo::getResultId).toList());
}
@Test
void historyIncludesActiveTaskOutsideResultWindow() throws Exception {
// 结果行窗口只装得下新任务;老任务还在跑,结果行已被挤出窗口
taskDb.add(task(900L, "RUNNING", LocalDateTime.of(2026, 8, 1, 8, 0)));
seed(3, 3, 0);
SimilarAsinHistoryVo vo = service.history(1L, 3);
assertEquals(4, vo.getItems().size(), "窗口外仍在跑的任务必须补回列表");
SimilarAsinHistoryItemVo first = vo.getItems().getFirst();
assertEquals(900L, first.getTaskId(), "补回项排在最前");
assertEquals("RUNNING", first.getTaskStatus());
assertNull(first.getResultId(), "补回项还没有结果行,不许伪造");
}
@Test
void historyDoesNotDuplicateActiveTaskAlreadyInWindow() throws Exception {
seed(1, 1, 0);
taskDb.getFirst().setStatus("RUNNING");
SimilarAsinHistoryVo vo = service.history(1L, 50);
assertEquals(1, vo.getItems().size(), "结果行已在窗口里的任务不得重复补回");
}
@Test
void historyHidesPendingPreviewButKeepsResumeCloneOutsideWindow() throws Exception {
taskDb.add(task(910L, "PENDING", LocalDateTime.of(2026, 8, 2, 9, 0)));
FileTaskEntity clone = task(911L, "PENDING", LocalDateTime.of(2026, 8, 2, 10, 0));
clone.setResumeOfTaskId(910L);
taskDb.add(clone);
seed(2, 2, 0);
SimilarAsinHistoryVo vo = service.history(1L, 50);
List<Long> taskIds = vo.getItems().stream().map(SimilarAsinHistoryItemVo::getTaskId).toList();
assertTrue(taskIds.contains(911L), "续跑克隆件必须可见(更新打断后就靠它显示)");
assertFalse(taskIds.contains(910L), "未启动的解析预览不进列表");
}
@Test
void historyMissingRelated() throws Exception {
resultDb.add(result(201L, 9999L, 1L, LocalDateTime.of(2026, 8, 1, 10, 1)));
@@ -344,10 +405,11 @@ class SimilarAsinTaskServiceHistoryBatchTest {
seed(20, 4, 20);
service.history(1L, 50);
verify(fileResultMapper, org.mockito.Mockito.times(1)).selectList(any());
verify(fileTaskMapper, org.mockito.Mockito.times(1)).selectList(any());
// 2 次固定任务查询:①结果行 taskId 的 IN 批查;②窗口外非终态任务的补回查询
verify(fileTaskMapper, org.mockito.Mockito.times(2)).selectList(any());
verify(taskFileJobService, org.mockito.Mockito.times(1)).findAssembleJobsByResultIds(eq(MODULE), anyList());
assertEquals(1, resultSelectCount.get(), "结果 1 次 IN 查询");
assertEquals(1, taskSelectCount.get(), "任务 1 次 IN 查询");
assertEquals(2, taskSelectCount.get(), "任务 2 次固定查询(IN 批查 + 非终态补回)");
assertEquals(1, jobSelectCount.get(), "Job 1 次 IN 查询");
assertEquals(20, resultSelectCount.get() * 20, "查询次数与结果行数无关(无 N+1)");
}
@@ -434,7 +434,8 @@ class SimilarAsinTaskServicePerf500Test {
jobQueryCount.set(0);
service.history(USER_ID, HISTORY_LIMIT);
assertTrue(resultSelectCount.get() <= 1, "history 结果查询 ≤ 1 次");
assertTrue(taskSelectCount.get() <= 1, "history 任务查询 ≤ 1 次");
// 2 次固定任务查询:①结果行 taskId 的 IN 批查;②窗口外非终态任务的补回查询(都是常数,与行数无关)
assertTrue(taskSelectCount.get() <= 2, "history 任务查询 ≤ 2 次");
assertTrue(jobQueryCount.get() <= 2, "history Job 查询 ≤ 2 次(findAssembleJobsByResultIds 一次)");
int historyTotal = resultSelectCount.get() + taskSelectCount.get() + jobQueryCount.get();
assertTrue(historyTotal <= MAX_QUERY_COUNT_HISTORY,
@@ -239,13 +239,35 @@ class SimilarAsinHistoryAssemblerTest {
Map<Long, FileTaskEntity> taskMap = new LinkedHashMap<>();
taskMap.put(10L, task(10L, "PENDING", null));
taskMap.put(11L, task(11L, "RUNNING", null));
// 续跑克隆件:客户端更新打断后 V129 自动续跑排回来的 PENDING(resume_of_task_id 指向原件),
// 原件已 FAILED 沉进历史,这一条再被跳过就两头都看不到——必须保留
taskMap.put(12L, task(12L, "PENDING", null));
taskMap.get(12L).setResumeOfTaskId(11L);
List<SimilarAsinHistoryItemVo> items = assembler.buildHistoryItems(
List.of(result(100L, 10L, "a.xlsx", null, 0), result(101L, 11L, "b.xlsx", null, 0)),
List.of(result(100L, 10L, "a.xlsx", null, 0),
result(101L, 11L, "b.xlsx", null, 0),
result(102L, 12L, "c.xlsx", null, 0)),
taskMap, jobMap());
assertEquals(1, items.size(), "PENDING 任务历史项被跳过");
assertEquals(101L, items.get(0).getResultId());
assertEquals(2, items.size(), "普通 PENDING 预览跳过,续跑克隆件保留");
assertEquals(List.of(101L, 102L),
items.stream().map(SimilarAsinHistoryItemVo::getResultId).toList());
assertEquals("PENDING", items.get(1).getTaskStatus(), "克隆件按排队中呈现");
}
@Test
void test_assembler_active_item_without_result_row() {
FileTaskEntity running = task(20L, "RUNNING", LocalDateTime.of(2026, 8, 2, 9, 0));
SimilarAsinHistoryItemVo item = assembler.buildActiveItem(running);
assertEquals(20L, item.getTaskId());
assertEquals("RUNNING", item.getTaskStatus());
assertNull(item.getResultId(), "还没有结果行,不许伪造 resultId");
assertNull(item.getDownloadUrl());
assertEquals(Boolean.FALSE, item.getSuccess());
assertEquals("2026-08-02T09:00", item.getStartedAt());
}
@Test