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
+2
View File
@@ -207,6 +207,8 @@ export const API_ENDPOINTS = {
/** 京东店铺商品采集(v1.4):建单走 LOCAL 通道,由本机客户端在已登录京麦的窗口内执行。 */
jdCollect: {
create: '/api/jd-collect/tasks',
/** 激活(PENDING→RUNNING):推客户端队列**之前**必须调用,否则分片被拒、心跳要求客户端收手 */
activate: '/api/jd-collect/tasks/{taskId}/activate',
/** 采集进度(用户端「获取店铺数据」进度条数据源) */
progress: '/api/jd-collect/tasks/{taskId}/progress',
heartbeat: '/api/jd-collect/tasks/{taskId}/heartbeat',
@@ -47,11 +47,29 @@ export function fetchJdCollectProgress(taskId: number) {
}))
}
/**
* 激活任务(PENDING→RUNNING):推客户端队列**之前**调用。
*
* 2026-11-14 真机实录:漏掉这一步,客户端第一个分片会被「任务不在运行中(PENDING)」拒收、
* 心跳回 alive=false 让客户端收手——采集白跑一轮。相似ASIN/货源等链路的同名入口即此形状。
* `user_id` 是 @RequestParam(与进度接口同口径),不是请求体字段。
*/
export function activateJdCollectTask(taskId: number) {
const path = buildJavaUrl(API_ENDPOINTS.jdCollect.activate.replace('{taskId}', String(taskId)))
const query = `?user_id=${encodeURIComponent(String(getCurrentUserId()))}`
return unwrapJavaResponse(post<JavaApiResponse<null>, Record<string, unknown>>(path + query, {}))
}
export function createJdCollectTask(shopName: string, listTabs: JdListTab[], maxProducts = 0) {
return unwrapJavaResponse(post<JavaApiResponse<JdCollectTaskVo>, Record<string, unknown>>(
buildJavaUrl(API_ENDPOINTS.jdCollect.create),
{
user_id: getCurrentUserId(),
// 建单请求体是 JSON(@RequestBody + JdCollectTaskCreateRequest),字段名必须是
// camelCase `userId`:Java 侧没有开 snake_case 命名策略,传 `user_id` 会被静默丢掉,
// 管理员(mayActForOtherUsers 走请求体值)建单时 userId 恒为 null ⇒ 后端回
// 「user_id 不合法」,页面上表现为点了「一键获取店铺数据」立刻失败。
// 进度接口的 `?user_id=` 是 @RequestParam,那个名字不动。
userId: getCurrentUserId(),
shopName,
listTabs,
maxProducts,