fix(guardrails): 京东上架五守卫格整量补记(24272a91 点名 87 例没跑整量、两处账本与四个分母漏记,2026-11-18 发版前整量 5689 例抓到)——①TaskFailureCategoryGuardrail B51-R1:JdPublishIngestService.summarizeTerminal 文案先落局部变量 message 再配对写列(原来三元里各写各的表达式被「写的列与文案不是同一个来源」判红;CollectDataService failTask 正本形状同源);②ApiGuardCoverageAuditor PENDING_CONVERGENCE 登记 /api/jd-publish(与 /api/jd-collect 逐形状同族:建单等五端点 requireOwnershipUserId fail-closed、chunk 判死口凭据化 isTrustedInternalToken 匿名拒绝判死、JdPublishChunkRequest 不带 userId 不进身份扫描);③RequestSuppliedIdentityOutletTest 写类分母 133→136(建单 DTO 形+activate+heartbeat 三支)、读类 67→69(items+progress 两支),chunk 不计入(留痕注释);④MigratedSqlEquivalenceTest XML_SELECT_TOTAL 103→105+NOT_MIGRATED 点名 JdPublishItemMapper#selectPublishableItems/countByPublishStatus;⑤SqlLayeringConventionTest XML_STATEMENT_TOTAL 147→149。判据:点名 5 类 34/34 绿+整量 5689 例(0 失败/19 skip)BUILD SUCCESS 9:51min——修复 jar 与平台隔离 jar 同窗

This commit is contained in:
2026-11-18 02:56:14 +08:00
parent 1105320354
commit b5578561df
5 changed files with 40 additions and 8 deletions
@@ -118,6 +118,11 @@ public class ApiGuardCoverageAuditor implements SmartInitializingSingleton {
* requireOwnershipUserId(fail-closed 401),chunk 与 heartbeat 和 collect-data/delete-brand
* 同形状(本机桌面执行器不带凭据,行归属以任务 owner 投影);chunk 的 error 上报已接整单
* 判死,其 owner 对撞收口随 v1.4 Phase 6.1 落,判死口凭据化后随统一批进名单</li>
* <li>{@code /api/jd-publish} —— v1.5 京东商品上架任务面(建单/activate/items/progress/chunk/
* heartbeat):与 /api/jd-collect 逐形状同族——建单等五端点方法体已有 requireOwnershipUserId
* (fail-closed 401,B98-07 同形债预防),chunk 判死口凭据化(isTrustedInternalToken,
* 匿名一律拒绝判死),行级落库与 jd-collect 同形状(本机桌面执行器不带凭据,行归属以
* 任务 owner 投影);判死口凭据化后随统一批进名单</li>
* </ul>
*/
static final Set<String> PENDING_CONVERGENCE = Set.of(
@@ -127,7 +132,8 @@ public class ApiGuardCoverageAuditor implements SmartInitializingSingleton {
"/api/delete-brand",
"/api/module-templates",
"/api/split",
"/api/jd-collect");
"/api/jd-collect",
"/api/jd-publish");
private final RequestMappingHandlerMapping handlerMapping;
@@ -170,6 +170,9 @@ public class JdPublishIngestService {
reason.append(",未发布 ").append(unpublished).append(" 行");
}
LocalDateTime now = LocalDateTime.now();
// 文案先落局部变量再配对写列(B51-R1 守卫「写的列与文案同一个来源」:列由同一句文案派生,
// 三元里各写各的表达式会被 TaskFailureCategoryGuardrailTest 判为不同源即红)。
String message = anyFailed ? reason.toString() : null;
int updated = fileTaskMapper.update(null, new LambdaUpdateWrapper<FileTaskEntity>()
.eq(FileTaskEntity::getId, taskId)
.eq(FileTaskEntity::getModuleType, JdPublishTaskService.MODULE_TYPE)
@@ -177,8 +180,8 @@ public class JdPublishIngestService {
.set(FileTaskEntity::getStatus, status)
.set(FileTaskEntity::getSuccessFileCount, success)
.set(FileTaskEntity::getFailedFileCount, failed)
.set(FileTaskEntity::getErrorMessage, anyFailed ? reason.toString() : null)
.set(FileTaskEntity::getFailureCategory, anyFailed ? TaskFailureLedger.categoryOf(reason.toString()) : null)
.set(FileTaskEntity::getErrorMessage, message)
.set(FileTaskEntity::getFailureCategory, message == null ? null : TaskFailureLedger.categoryOf(message))
.set(FileTaskEntity::getUpdatedAt, now)
.set(FileTaskEntity::getFinishedAt, now));
if (updated > 0) {
@@ -106,7 +106,10 @@ class MigratedSqlEquivalenceTest {
// 该笔当时只点编译没跑整量、两处账本都漏记,2026-11-15 发版前整量抓到补记。
// 114 → 103:keywordshare 模块整体下线(Project-Slimming 第三轮:6.4 天访问日志零流量、
// 四树零引用、V165 已撤菜单),随删 11 条 select 与下方 NOT_MIGRATED 的 12 条点名。
private static final int XML_SELECT_TOTAL = 103;
// 103 → 105:2026-11-18 整量补记 v1.5 Phase 2(24272a91)JdPublishItemMapper 新写 2 条
// 只读 select(selectPublishableItems + countByPublishStatus),逐条点名进 NOT_MIGRATED
//(SqlLayeringConventionTest.XML_STATEMENT_TOTAL 同轮 147 → 149)。
private static final int XML_SELECT_TOTAL = 105;
/**
* 不是「从注解搬过来」的语句:注解时代没有原文可对撞,等价性这支只能跳过它们。
@@ -217,7 +220,14 @@ class MigratedSqlEquivalenceTest {
// 注解时代原文没有这列(同批 selectAllGroups 也漏了 platform 投影,那已在
// 上面豁免),平台闸读不到平台档把全部组清空。按同款先例整行摘账本点名留痕
// (LEDGER_ROWS 82 → 81 / SELECTS 58 → 57);新形状由 ShopManageGroupScopeSqlTest 钉。
"ShopManageGroupMapper#selectLedGroups");
"ShopManageGroupMapper#selectLedGroups",
// 2026-11-18 整量补记:v1.5 Phase 2 京东商品上架(24272a91)JdPublishItemMapper
// 新写 2 条只读 select(selectPublishableItems 明细分批下发页 PENDING 谓词+id 游标、
// countByPublishStatus 行级状态聚合),从来没有注解原文可对撞,逐条点名留痕。
// 该笔点名 12 类 87 例没跑整量、两处账本漏记,2026-11-18 发版前整量抓到补记
//(XML_SELECT_TOTAL 103 → 105,SqlLayeringConventionTest.XML_STATEMENT_TOTAL 同轮 147 → 149)。
"JdPublishItemMapper#selectPublishableItems",
"JdPublishItemMapper#countByPublishStatus");
/** 账本 5 列:接口 / 方法 / @Select 种类 / 是否含常量插值 / 注解原文(Java 反转义后那条串)。 */
private static final int LEDGER_COLUMNS = 5;
@@ -131,7 +131,11 @@ class SqlLayeringConventionTest {
// 164 → 147:keywordshare 模块整体下线(Project-Slimming 第三轮:6.4 天访问日志零流量、
// 四树零引用、V165 已撤菜单),4 份 XML 17 条语句(11 select + 4 insert + 1 delete)随删;
// 同轮 MigratedSqlEquivalenceTest.XML_SELECT_TOTAL 114 → 103、NOT_MIGRATED 摘掉 12 条点名。
private static final int XML_STATEMENT_TOTAL = 147;
// 147 → 149:2026-11-18 整量补记 v1.5 Phase 2(24272a91)京东商品上架在 JdPublishItemMapper
// 落 2 条只读 select(selectPublishableItems 明细分批下发页 + countByPublishStatus 行级聚合),
// 全部新写,非迁移语句;同轮登记进 MigratedSqlEquivalenceTest.NOT_MIGRATED
//(该文件 XML_SELECT_TOTAL 同轮 103 → 105)。
private static final int XML_STATEMENT_TOTAL = 149;
/**
* wrapper 里夹带函数级 SQL 的现状("这不是简单单表"的证据),文件名 → 条数:
@@ -107,7 +107,13 @@ class RequestSuppliedIdentityOutletTest {
// POST /api/jd-collect/tasks/progress/batch(批量进度:request.userId 先过 requireOwnershipUserId
// 再 filterOwnedTaskIds 过滤归属)+ DELETE /api/jd-collect/tasks/{taskId}(@RequestParam("user_id")
// 先过 resolveOwnershipUserId,删除任务行连带 jd 三表)——覆盖面变大,不是放宽分母。
assertThat(scan.boundWrite()).as("取请求身份且已接出口的写类 handler 数").isEqualTo(133);
// 136 而不是 133:2026-11-18 v1.5 Phase 2 京东商品上架(24272a91)新增三支写类端点——
// POST /api/jd-publish/tasks(建单:JdPublishTaskCreateRequest 带 userId DTO 形,先过
// requireOwnershipUserId fail-closed、请求体自带值不采信)+ POST /api/jd-publish/tasks/{taskId}/activate
// + POST /api/jd-publish/tasks/{taskId}/heartbeat(都是 @RequestParam("user_id") 先过
// requireOwnershipUserId);chunk 回传不走身份出口(判死口凭据化 isTrustedInternalToken,
// JdPublishChunkRequest 不带 userId 字段),不计入——覆盖面变大,不是放宽分母。
assertThat(scan.boundWrite()).as("取请求身份且已接出口的写类 handler 数").isEqualTo(136);
// 64 而不是 63:2026-10-29 随本地采集开关恢复 GET /tasks/{taskId}/queue-payload,
// 该 handler 同时接上 resolveOwnershipUserId(不是放宽分母)。
// 65 而不是 64:2026-11-14 v1.4 新增 JdCollectController GET /api/jd-collect/tasks/{taskId}/progress
@@ -116,7 +122,10 @@ class RequestSuppliedIdentityOutletTest {
// 67 而不是 65:2026-11-15 京东任务面板改版(45d0989a)新增两支读类端点——
// GET /api/jd-collect/dashboard(统计卡)+ GET /api/jd-collect/history(历史层,limit 钳制 1..100),
// 都是 @RequestParam("user_id") 先过 resolveOwnershipUserId——覆盖面变大,不是放宽分母。
assertThat(scan.boundRead()).as("取请求身份且已接出口的读类 handler 数").isEqualTo(67);
// 69 而不是 67:2026-11-18 v1.5 Phase 2 新增两支读类端点——GET /api/jd-publish/tasks/{taskId}/items
// + GET /api/jd-publish/tasks/{taskId}/progress,都是 @RequestParam("user_id") 先过
// requireOwnershipUserId——覆盖面变大,不是放宽分母。
assertThat(scan.boundRead()).as("取请求身份且已接出口的读类 handler 数").isEqualTo(69);
assertThat(scan.unbound()).as("取请求身份但未接出口的 handler:只剩豁免那一条")
.containsExactlyElementsOf(ALLOWED_WITHOUT_OUTLET);
}