fix(phase-6.1): CR 六项修复——派发链三件套/登记顺序/判死口凭据化/脏时间可读/UPDATE 段摘死列

This commit is contained in:
2026-11-14 13:53:03 +08:00
parent edeffc26c4
commit 796ec2130f
10 changed files with 346 additions and 32 deletions
@@ -65,8 +65,12 @@ public class JdCollectController {
public ApiResponse<JdIngestChunkVo> submitChunk(
@Parameter(description = "任务 ID", required = true, example = "33890")
@PathVariable Long taskId,
@RequestBody JdIngestChunkRequest request) {
return ApiResponse.success(ingestService.submitChunk(taskId, request));
@RequestBody JdIngestChunkRequest request,
HttpServletRequest httpRequest) {
// P1-2 判死口凭据化:error 上报是唯一能触发整单判死的入口,匿名一律拒绝判死
// (items 落库仍走 PENDING_CONVERGENCE 既有欠账形状)。可信判定单一出口 isTrustedInternalToken。
boolean trustedErrorReporter = adminAuthSupport.isTrustedInternalToken(httpRequest);
return ApiResponse.success(ingestService.submitChunk(taskId, request, trustedErrorReporter));
}
@PostMapping("/tasks/{taskId}/heartbeat")
@@ -72,7 +72,7 @@ public class JdResultIngestService {
private final JdProductImageIngestService jdProductImageIngestService;
private final ObjectMapper objectMapper;
public JdIngestChunkVo submitChunk(Long taskId, JdIngestChunkRequest request) {
public JdIngestChunkVo submitChunk(Long taskId, JdIngestChunkRequest request, boolean trustedErrorReporter) {
if (taskId == null || taskId <= 0) {
throw new BusinessException("taskId 不合法");
}
@@ -84,7 +84,7 @@ public class JdResultIngestService {
throw new BusinessException("任务已结束(" + task.getStatus() + "),回传被拒");
}
if (request.getError() != null && !request.getError().isBlank()) {
return handleErrorReport(task, request.getError().trim());
return handleErrorReport(task, request.getError().trim(), trustedErrorReporter);
}
if (!STATUS_RUNNING.equals(task.getStatus())) {
throw new BusinessException("任务不在运行中(" + task.getStatus() + "),回传被拒");
@@ -102,6 +102,10 @@ public class JdResultIngestService {
int deduped = 0;
int imageCount = 0;
List<JdProductEntity> rows = new ArrayList<>();
// 图片登记延后到 upsert 之后(P0-2):registerTaskImages 按 companyId+taskId+productCode
// 查商品行,首采行在 upsert 前必然不存在 → 登记会被 100% 跳过、图片永远落不了库。
// 这里先收集,行落库后再逐商品登记。
List<PendingImageRegistration> pendingImages = new ArrayList<>();
if (request.getItems() != null) {
for (JdIngestChunkRequest.JdIngestItemDto item : request.getItems()) {
if (item == null || isBlank(item.getProductCode())) {
@@ -116,15 +120,19 @@ public class JdResultIngestService {
continue;
}
rows.add(buildRow(task, companyId, createRequest, item, summary, request.getBatchId(), scope));
// Phase 4:直传完成的图片清单按 statObject 对撞落 biz_jd_product_image(登记链唯一出口
// JdProductImageIngestService,uk_product_image 幂等;商品行未落库时跳过不落孤儿行)。
imageCount += jdProductImageIngestService.registerTaskImages(taskId, companyId,
item.getProductCode().trim(), toImageSpecs(item.getImages()));
pendingImages.add(new PendingImageRegistration(item.getProductCode().trim(),
toImageSpecs(item.getImages())));
}
}
if (!rows.isEmpty()) {
jdProductMapper.upsertBatch(rows);
}
// Phase 4:直传完成的图片清单按 statObject 对撞落 biz_jd_product_image(登记链唯一出口
// JdProductImageIngestService,uk_product_image 幂等)——必须在商品行落库之后执行。
for (PendingImageRegistration pending : pendingImages) {
imageCount += jdProductImageIngestService.registerTaskImages(taskId, companyId,
pending.productCode(), pending.specs());
}
int itemsReceived = mergeScopeState(scope, request, request.getItems() == null ? 0 : request.getItems().size());
if (Boolean.TRUE.equals(request.getIsEnd())) {
finalizeSuccess(task, itemsReceived);
@@ -137,8 +145,17 @@ public class JdResultIngestService {
return vo;
}
/** 铁律 31 分档:京麦登录态失效 → 整单终态;代理/LLM 致命 → CredentialFatalTaskCloser;其余只记录。 */
private JdIngestChunkVo handleErrorReport(FileTaskEntity task, String error) {
/** 铁律 31 分档:京麦登录态失效 → 整单终态;代理/LLM 致命 → CredentialFatalTaskCloser;其余只记录。
*
* <p>P1-2:error 上报是唯一能触发整单判死的入口,只认可信内部凭据(X-Internal-Token,
* 判定单一出口 isTrustedInternalToken)——匿名 error 一律拒绝判死(不碰任务状态),
* 防止枚举 taskId 即可把任意 RUNNING 京东任务判死。</p>
*/
private JdIngestChunkVo handleErrorReport(FileTaskEntity task, String error, boolean trustedErrorReporter) {
if (!trustedErrorReporter) {
log.warn("[{}] 匿名失败上报拒绝判死(缺可信内部凭据)taskId={} err={}", LOG_TAG, task.getId(), error);
return reject("失败上报需要可信内部凭据(X-Internal-Token),已拒绝判死");
}
if (JdStaleTaskService.isJdLoginStateFailure(error)) {
jdStaleTaskService.terminalizeOnJdLoginFatal(task, error);
return reject("京麦登录态失效,任务已终止,请在客户端重新登录京麦");
@@ -316,13 +333,18 @@ public class JdResultIngestService {
}
}
/** 京东侧时间口径 yyyy-MM-dd HH:mm:ss(容 ISO 的 T 分隔,归一后单格式解析;解析失败直接拒批,不静默置空)。 */
private static LocalDateTime parseJdTime(String raw) {
/** 京东侧时间口径 yyyy-MM-dd HH:mm:ss(容 ISO 的 T 分隔,归一后单格式解析;解析失败可读拒批,不静默置空)。 */
static LocalDateTime parseJdTime(String raw) {
if (raw == null || raw.isBlank()) {
return null;
}
return LocalDateTime.parse(raw.trim().replace('T', ' '),
DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"));
String normalized = raw.trim().replace('T', ' ');
try {
return LocalDateTime.parse(normalized, DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"));
} catch (java.time.format.DateTimeParseException ex) {
// 一行脏时间不许让整批回传 500 裸堆栈:抛可读拒绝(原文进 message,不进堆栈页)。
throw new BusinessException("京东时间格式不识别(应为 yyyy-MM-dd HH:mm:ss): " + normalized);
}
}
private String cursorTab(TaskScopeStateEntity scope) {
@@ -383,4 +405,9 @@ public class JdResultIngestService {
private static final com.fasterxml.jackson.core.type.TypeReference<Map<String, Object>> STATE_TYPE =
new com.fasterxml.jackson.core.type.TypeReference<>() {
};
/** 延后登记的图片明细(P0-2:商品行 upsert 之后才查得到行,登记必须延后)。 */
private record PendingImageRegistration(String productCode,
List<JdProductImageIngestService.JdIngestImageSpec> specs) {
}
}
@@ -0,0 +1,52 @@
package com.nanri.aiimage.modules.jd.service;
import com.nanri.aiimage.modules.jd.model.dto.JdCollectTaskCreateRequest;
import com.nanri.aiimage.modules.task.model.entity.FileTaskEntity;
import com.nanri.aiimage.modules.task.spi.ClientTaskPullSpi;
import lombok.RequiredArgsConstructor;
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Service;
import java.util.LinkedHashMap;
import java.util.Map;
/**
* 京东店铺采集的客户端兜底拉取实现(v1.4 Phase 6.1 修 P0-1:派发链断头)。
*
* <p>页面推送缺失(只建单没推送 / 推送前关页面 / 纯浏览器打开)时任务会停在 PENDING,
* {@code TaskClientPullService} 认领后由本实现组装可直接入队的载荷。{@code data} 的键集
* 与客户端 {@code jd_base.process_task} 的读取契约同键({@code taskId / shopName /
* listTabs / maxProducts},{@code QUEUE_TYPE} 与客户端 {@code amazon.jd.jd_base.QUEUE_TYPE}
* 同值 {@code jd-shop-collect-run})——两处任意一处漂移,兜底拉下来的任务客户端不识别。</p>
*
* <p>shopName/listTabs/maxProducts 从建单载荷({@code request_json})回读,与页面推送
* 同源;载荷解析失败按 SPI 语义返回 null(调用方会把任务标失败并回写原因),不静默出空载荷。</p>
*/
@Slf4j
@Service
@RequiredArgsConstructor
public class JdTaskPullSpiImpl implements ClientTaskPullSpi {
/** 与客户端 amazon/jd/jd_base.py 的 QUEUE_TYPE 逐字同值(改这里必须同轮改客户端)。 */
public static final String QUEUE_TYPE = "jd-shop-collect-run";
private final JdCollectTaskService collectTaskService;
@Override
public String moduleType() {
return JdCollectTaskService.MODULE_TYPE;
}
@Override
public Map<String, Object> buildQueuePayload(FileTaskEntity task) {
JdCollectTaskCreateRequest create = collectTaskService.readCreateRequest(task);
Map<String, Object> data = new LinkedHashMap<>();
data.put("taskId", task.getId());
data.put("shopName", create.getShopName());
data.put("listTabs", create.getListTabs());
data.put("maxProducts", create.getMaxProducts());
log.info("[jd-collect] 兜底载荷已组装 taskId={} shopName={} tabs={}",
task.getId(), create.getShopName(), create.getListTabs());
return Map.of("type", QUEUE_TYPE, "data", data);
}
}