fix(jd-collect): 补「激活」这一步——页面先 PENDING->RUNNING 再推客户端队列,否则分片全被拒

真机 task 34399 实录:页面建完单直接推客户端,任务仍是 PENDING,JdResultIngestService 只收 RUNNING 的分片、心跳对非 RUNNING 回 alive=false,客户端第一个分片被「任务不在运行中(PENDING),回传被拒」后当场收手,采集白跑一轮。相似ASIN/货源/外观专利/数据采集四条链都有同名 activate 入口,京东这条在建单入口漏了。
This commit is contained in:
2026-11-14 21:32:49 +08:00
parent 47278ee425
commit 8d8c88a5f3
8 changed files with 292 additions and 55 deletions
@@ -61,6 +61,21 @@ public class JdCollectController {
adminAuthSupport.currentDeviceId(httpRequest)));
}
@PostMapping("/tasks/{taskId}/activate")
@Operation(summary = "激活京东采集任务", description = "页面把 jd-shop-collect-run 载荷推给本机客户端前调用:"
+ "PENDING→RUNNING 条件更新。漏掉这一步,客户端的第一个分片会被「任务不在运行中(PENDING)」"
+ "拒收、心跳回 alive=false 要求客户端收手,采集白跑一轮(2026-11-14 真机实录)。")
public ApiResponse<Void> activate(
@Parameter(description = "任务 ID", required = true, example = "34398")
@PathVariable Long taskId,
@Parameter(description = "任务所属用户 ID;省略时取当前登录身份", required = false, example = "1")
@RequestParam(value = "user_id", required = false) Long userId,
HttpServletRequest httpRequest) {
collectTaskService.activateTask(taskId,
adminAuthSupport.requireOwnershipUserId(httpRequest, userId));
return ApiResponse.success(null);
}
@GetMapping("/tasks/{taskId}/progress")
@Operation(summary = "查询京东采集进度", description = "用户端「获取店铺数据」进度条数据源:"
+ "任务状态 + 已回传商品数 + 列表 total(客户端抓首页时写入游标) + 当前页/Tab + 已收批次数。"
@@ -48,6 +48,7 @@ public class JdCollectTaskService {
public static final String MODULE_TYPE = CollectRoutingProperties.MODULE_JD_SHOP_COLLECT;
private static final String STATUS_PENDING = com.nanri.aiimage.common.task.TaskStatuses.FileTask.PENDING;
private static final String STATUS_RUNNING = com.nanri.aiimage.common.task.TaskStatuses.FileTask.RUNNING;
/** 京麦商品列表 Tab 词表(与 V193 list_tab 列同词表)。 */
private static final Set<String> VALID_LIST_TABS = Set.of("ONSALE", "OFFSALE");
@@ -97,6 +98,40 @@ public class JdCollectTaskService {
return vo;
}
/**
* 激活任务(PENDING→RUNNING)——页面把载荷推给本机客户端<b>之前</b>调用。
*
* <p>为什么必须有这一步(2026-11-14 真机实录):`JdResultIngestService` 只接受 RUNNING
* 任务的分片,心跳对非 RUNNING 一律回 `alive=false`;页面建完单直接推客户端时任务还是
* PENDING ⇒ 第一个分片被拒(「任务不在运行中(PENDING)」)、心跳要求客户端收手,
* 采集白跑一轮。相似ASIN/货源/外观专利/上架四条链都有同名 activate 入口,京东这条漏了。
*
* <p>只允许 PENDING→RUNNING(条件更新):与客户端「兜底拉取」的原子认领互斥,
* 谁先翻转谁执行,页面与客户端不会重复跑同一单。
*/
public void activateTask(Long taskId, Long userId) {
FileTaskEntity task = fileTaskMapper.selectById(taskId);
// 归属谓词走公共出口(TaskLifecycleDebtRatchetTest 棘轮只许降:新增手写遍数即红)。
if (task == null || !TaskFinalizeSupport.belongsToModule(MODULE_TYPE, task.getModuleType())
|| (userId != null && task.getUserId() != null && !Objects.equals(userId, task.getUserId()))) {
throw new BusinessException("任务不存在");
}
int updated = fileTaskMapper.update(null,
new com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper<FileTaskEntity>()
.eq(FileTaskEntity::getId, taskId)
.eq(FileTaskEntity::getStatus, STATUS_PENDING)
.set(FileTaskEntity::getStatus, STATUS_RUNNING)
.set(FileTaskEntity::getUpdatedAt, LocalDateTime.now()));
if (updated == 0) {
FileTaskEntity latest = fileTaskMapper.selectById(taskId);
if (latest != null && STATUS_RUNNING.equals(latest.getStatus())) {
throw new BusinessException("任务已在执行中(可能已由客户端自动接管),无需重复启动");
}
throw new BusinessException("任务已结束");
}
log.info("[jd-collect] 已激活(PENDING→RUNNING) taskId={} userId={}", taskId, task.getUserId());
}
private void validate(JdCollectTaskCreateRequest request) {
if (request.getUserId() == null || request.getUserId() <= 0) {
throw new BusinessException("user_id 不合法");