feat(submit-gate): 缺 LLM 密钥的外观专利/相似ASIN 单在建单口当场拒

用户口径(2026-11-01):「没配置代理的不止是变体采集要拦,其他任务也是一样,包括 llm 密钥。」
这一支是服务端那半边——两把 LLM 密钥此前是**静默降级**:readApiKey 读空只打一条
log.warn,然后「保留原始行」把单子跑完、把表出出来,整列检测结论却是空的。
用户买到一张没检测过的结果表却看不出来,比一句「没配密钥」的失败更难发现;
而 UserSecretModule 早就把这两把密钥登记成 required=true(用户端必填),闸门只是把
这句声明变成会拦事的代码。

- UserApiSecretService#requireSubmitSecret:请求体带的密钥与库里存的那把,有一个非空即放行;
  两侧都空当场 BusinessException(文案点名是哪把密钥、去哪配)
- 外观专利 AppearancePatentTaskService.parseAndCreateTask / 相似ASIN
  SimilarAsinTaskService.parseAndCreateTask:闸门排在 Excel 解析与建单四段**之前**,
  不解析、不落库、不占配额;userId 校验仍在最前(先判身份再判凭据)
- 用例:UserApiSecretServiceTest 3 支(两侧都空拒 / 带值放行且不读库 / 库存量放行)、
  两支建单快照各 2 支(缺密钥不碰源文件不落库;正向对照验模块与请求密钥同值)
- 六支 SimilarAsinTaskService*Test 补 @Mock UserApiSecretService:@InjectMocks 缺该类型
  会注进 null,闸门调用直接 NPE——这是把闸门接真后必须显式登记的依赖
- RequestSuppliedIdentityOutletTest 写类分母 126→128:2026-11-01「原任务重试」新增的两支
  POST 端点(TaskRetryController / AppearancePatentController)都已接 resolveOwnershipUserId,
  覆盖面变大不是放宽判据;该红是当时只跑四面闸门、没点后端整量留下的陈旧分母

后端整量 mvn -o test:5164 例(本笔改动 0 红;唯一一处红即上述陈旧分母,已随本笔抬正)
This commit is contained in:
2026-11-02 00:33:58 +08:00
parent 8f206a6019
commit 7f5437d012
13 changed files with 174 additions and 5 deletions
@@ -180,6 +180,11 @@ public class AppearancePatentTaskService extends AbstractFileTaskPipeline<Appear
}
public AppearancePatentParseVo parseAndCreateTask(AppearancePatentParseRequest request, String deviceId) {
// 密钥闸门排在解析之前:Excel 解析与建单四段都要花时间与配额,而缺密钥的单跑完也只是
// 一张没有 LLM 结论的表(判据见 UserApiSecretService#requireSubmitSecret)。
requireUserId(request.getUserId());
userApiSecretService.requireSubmitSecret(request.getUserId(),
UserSecretModule.APPEARANCE_PATENT, request.getApiKey());
return parsePipeline().parseAndCreateTask(request, deviceId);
}
@@ -75,6 +75,7 @@ import com.nanri.aiimage.modules.task.service.TaskRetryEligibility;
import com.nanri.aiimage.modules.task.service.TaskVisibleFailureNotice;
import com.nanri.aiimage.modules.task.service.TransientPayloadStorageService;
import com.nanri.aiimage.modules.usersecret.service.UserApiSecretService;
import com.nanri.aiimage.modules.usersecret.support.UserSecretModule;
import lombok.RequiredArgsConstructor;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
@@ -390,6 +391,10 @@ public class SimilarAsinTaskService implements SimilarAsinPipelineHost {
if (request.getUserId() == null || request.getUserId() <= 0) {
throw new BusinessException("user_id 不合法");
}
// 密钥闸门排在解析之前:解析、建单四段都要花时间与配额,而缺密钥的单跑完只是
// 一张没有 LLM 结论的表(判据见 UserApiSecretService#requireSubmitSecret)。
userApiSecretService.requireSubmitSecret(request.getUserId(),
UserSecretModule.SIMILAR_ASIN, request.getApiKey());
if (request.getFiles() == null || request.getFiles().isEmpty()) {
throw new BusinessException("请先上传 Excel 文件");
}
@@ -292,6 +292,28 @@ public class UserApiSecretService implements UserSecretCleanupPort {
}
}
/**
* 建单前置:这一单要拿谁的密钥跑 LLM,此刻就得说清。调用方带的密钥(显式覆盖/老任务形状)
* 与该用户存好的密钥,两者有一个非空即放行;<b>都为空必须当场拒</b>。
*
* <p>为什么不能放过去:执行侧读到空密钥走的是「保留原始行」的静默降级
* ({@code AppearancePatentLlmSubmissionSupport#readApiKey} 那两条 log.warn)——单子照样跑完、
* 表照样出、行数照样扣,只是整列 LLM 结论是空的。用户买到一张没有检测过的结果表却看不出来,
* 比一句「没配密钥」的失败更难发现。
*
* <p>调用方须先校验 userId(各模块自己的入口文案为准),这里不重复判。
*/
public void requireSubmitSecret(Long userId, UserSecretModule module, String callerSuppliedValue) {
if (hasText(callerSuppliedValue)) {
return;
}
if (!findPlainValue(userId, module.key()).isEmpty()) {
return;
}
throw new BusinessException("该账号还没有配置" + module.label() + ":这一单要用它跑 LLM 检测,"
+ "缺了只会得到一张没有检测结论的结果表。请先在「密钥设置」里填好并保存。");
}
/**
* 任务执行兜底读取「货源」:未配置返回空串(调用方按模块默认值处理)。
* 代理模块额外做链接域名识别,兜住老数据(只有链接、没有供应商列)的存量行。