test(phase-3): 3D 收口——publish 建单段 golden 落地,七支「先补再动」最后一格缺口闭合

PublishTaskService 一字未改。新落 PublishCreateTaskSnapshotTest(吃真入口
parseAndCreateTask)+ publish/golden/create-task-snapshot.txt:7 段场景由
7 支执行用例渲染,第 8 支是写档器(无 SHUFU_SNAPSHOT_WRITE 即 skip)。

补这支的理由:3D 迁移本体当时把 newTaskHeader/insertTask/newScopeRow 换成底座件,
等值证据只有「旧块/现块/底座件体做 setter 差集」——推理级证据,不是可复跑的防线。
本支在册两条快照都碰不到建单:PublishBatchLoadingSnapshotEquivTest 吃读侧
(history/dashboard/getTaskDetail/getTaskProgress),PublishSubmitResultSnapshotTest
吃 submitResult。

钉住的现网形状(逐段读 golden 得来,非推测):
1. 解析在事务外、落库在事务内:tx.begin→task.insert→file.insert→item.insertBatch
   →result.insert→tx.commit,一次 execute();
2. 建单时刻一枚复用给头行/文件行/结果行(同一枚引用),而 insertRows 自己再取一次
   now ⇒ 行项目 createdAt 与之不同——这条不对称由 itemCreatedAtEqualsTaskNow=false 钉住;
3. 文件解析失败不抛只标 FAILED,有一个可用任务仍 PENDING;全失败才 FAILED
   +「全部文件解析或店铺匹配失败」+ finishedAt,且结果行照插(rowCount=0);
4. 计数与落库不同径:totalRows/rowCount 取 rows.size() 含 null,insertRows 跳 null;
   0 行不调 insertBatch 但文件仍 PENDING、任务照样建起来;
5. 结果行 success 写 0(AP 留 NULL、ShopDataCrawl 写 -1,三种形状);
6. 行内品牌在落库那格过 BrandLabel.strip:"品牌: 耐克"→"耐克"、
   "Brand: NIKE: X"→"NIKE: X"(只剥行首一枚标签)、全角冒号同样剥。

两处夹具自踩(都是「不判红就看不见的假证据」那一族):① 兜底 stub 若用 when(any())
注册在调用方 when("shop-a") 之后,Mockito 后注册者优先会把具体桩顶掉 ⇒ 匹配分流
收敛成一枚 thenAnswer;② tx.begin 整条不含空格,照 AP 那版 substring(0, indexOf(' '))
取事件名当场越界 ⇒ 补 eventKind 容错。

门禁:mvn -o test-compile rc=0;整类 9 例/0 红/1 skip;定向(Publish* 全面+
SourceScan/TaskModuleCoverage/CatchSilence/ArchitectureBoundary/LockSkip/
TaskStatusVocabulary/TaskLifecycleDebt/ForbiddenLogAudit/SqlLayering/
TaskServiceWiringSlice)205 例/0 红/2 skip;后端整量单跑 4616 例/0 红/0 错/
17 skipped,BUILD SUCCESS,真实 rc=0;golden 非写模式逐字节复现,
git status 仅本笔两件、其余快照一字未动。ops 面 ruff All checks passed。
真机启动验收本格仍欠(本机无 MySQL/Redis 监听,本笔零生产码改动)。
This commit is contained in:
2026-10-21 00:07:10 +08:00
parent 74384fa6ac
commit 479114cf95
2 changed files with 710 additions and 0 deletions
@@ -0,0 +1,72 @@
== 单文件建单:匹配成功、解析两行 ==
tx.begin
task.insert taskNo=PUBLISH-<snowflake> moduleType=PUBLISH status=PENDING taskMode=PYTHON_QUEUE sourceFileCount=1 successFileCount=0 failedFileCount=0 userId=7 createdBy=user:7 deviceId=device-1 errorMessage=null finishedAtSet=false requestJson.keys=[files,fileKey,originalFilename,relativePath,user_id,publish_country,sync_countries] requestJson.digest=d94395576c95 resultJson={"ownerInstanceId":"node-A"}
file.insert taskId=1001 fileId=2001 fileKey=uploads/shop-a.xlsx sourceFilename=shop-a.xlsx relativePath=shop-a.xlsx shopName=shop-a matched=1 shopId=shop-9 matchedUserId=42 platform=amazon companyName=ACME 有限公司 matchStatus=MATCHED matchMessage= status=PENDING totalRows=2 processedRows=0 errorMessage=null finishedAtSet=false createdAtEqualsTaskNow=true
item.insertBatch count=2 taskId=1001 fileId=2001 rowIndex=[1,2] asins=[B001,B002] brands=[耐克,Adidas] itemCreatedAtEqualsTaskNow=false
result.insert taskId=1001 moduleType=PUBLISH sourceFilename=shop-a.xlsx sourceFileUrl=uploads/shop-a.xlsx resultContentType=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet rowCount=2 success=0 errorMessage=null userId=7 createdAtEqualsTaskNow=true
tx.commit
vo: taskId=1001 taskNo=PUBLISH-<snowflake> sourceFileCount=1 totalRows=2 pageSize=50
vo.file fileId=2001 fileKey=uploads/shop-a.xlsx shopName=shop-a matched=true status=PENDING totalRows=2 percent=0 errorMessage=null
== 双文件聚合:结果类型换 zip、URL 取首文件、行号逐文件重计 ==
tx.begin
task.insert taskNo=PUBLISH-<snowflake> moduleType=PUBLISH status=PENDING taskMode=PYTHON_QUEUE sourceFileCount=2 successFileCount=0 failedFileCount=0 userId=7 createdBy=user:7 deviceId=device-2 errorMessage=null finishedAtSet=false requestJson.keys=[files,fileKey,originalFilename,relativePath,fileKey,originalFilename,relativePath,user_id,publish_country,sync_countries] requestJson.digest=02e9718f0b2b resultJson={"ownerInstanceId":"node-A"}
file.insert taskId=1001 fileId=2001 fileKey=uploads/a.xlsx sourceFilename=a.xlsx relativePath=a.xlsx shopName=a matched=1 shopId=shop-9 matchedUserId=42 platform=amazon companyName=ACME 有限公司 matchStatus=MATCHED matchMessage= status=PENDING totalRows=1 processedRows=0 errorMessage=null finishedAtSet=false createdAtEqualsTaskNow=true
item.insertBatch count=1 taskId=1001 fileId=2001 rowIndex=[1] asins=[B001] brands=[Nike] itemCreatedAtEqualsTaskNow=false
file.insert taskId=1001 fileId=2002 fileKey=uploads/b.xlsx sourceFilename=b.xlsx relativePath=b.xlsx shopName=b matched=1 shopId=shop-9 matchedUserId=42 platform=amazon companyName=ACME 有限公司 matchStatus=MATCHED matchMessage= status=PENDING totalRows=2 processedRows=0 errorMessage=null finishedAtSet=false createdAtEqualsTaskNow=true
item.insertBatch count=2 taskId=1001 fileId=2002 rowIndex=[1,2] asins=[B002,B003] brands=[Puma,Asics] itemCreatedAtEqualsTaskNow=false
result.insert taskId=1001 moduleType=PUBLISH sourceFilename=a.xlsx 等 2 个文件 sourceFileUrl=uploads/a.xlsx resultContentType=application/zip rowCount=3 success=0 errorMessage=null userId=7 createdAtEqualsTaskNow=true
tx.commit
vo: taskId=1001 taskNo=PUBLISH-<snowflake> sourceFileCount=2 totalRows=3 pageSize=50
vo.file fileId=2001 fileKey=uploads/a.xlsx shopName=a matched=true status=PENDING totalRows=1 percent=0 errorMessage=null
vo.file fileId=2002 fileKey=uploads/b.xlsx shopName=b matched=true status=PENDING totalRows=2 percent=0 errorMessage=null
== 店铺未匹配:文件行 FAILED 但任务仍 PENDING(有一个可用就进队列) ==
tx.begin
task.insert taskNo=PUBLISH-<snowflake> moduleType=PUBLISH status=PENDING taskMode=PYTHON_QUEUE sourceFileCount=2 successFileCount=0 failedFileCount=1 userId=7 createdBy=user:7 deviceId=null errorMessage=null finishedAtSet=false requestJson.keys=[files,fileKey,originalFilename,relativePath,fileKey,originalFilename,relativePath,user_id,publish_country,sync_countries] requestJson.digest=e0166e85bd50 resultJson={"ownerInstanceId":"node-A"}
file.insert taskId=1001 fileId=2001 fileKey=uploads/a.xlsx sourceFilename=shop-a.xlsx relativePath=a.xlsx shopName=shop-a matched=1 shopId=shop-9 matchedUserId=42 platform=amazon companyName=ACME 有限公司 matchStatus=MATCHED matchMessage= status=PENDING totalRows=1 processedRows=0 errorMessage=null finishedAtSet=false createdAtEqualsTaskNow=true
item.insertBatch count=1 taskId=1001 fileId=2001 rowIndex=[1] asins=[B001] brands=[Nike] itemCreatedAtEqualsTaskNow=false
file.insert taskId=1001 fileId=2002 fileKey=uploads/b.xlsx sourceFilename=shop-b.xlsx relativePath=b.xlsx shopName=shop-b matched=0 shopId=null matchedUserId=null platform=null companyName=null matchStatus=null matchMessage=null status=FAILED totalRows=0 processedRows=0 errorMessage=店铺未匹配到紫鸟索引 finishedAtSet=true createdAtEqualsTaskNow=true
result.insert taskId=1001 moduleType=PUBLISH sourceFilename=shop-a.xlsx 等 2 个文件 sourceFileUrl=uploads/a.xlsx resultContentType=application/zip rowCount=1 success=0 errorMessage=null userId=7 createdAtEqualsTaskNow=true
tx.commit
vo: taskId=1001 taskNo=PUBLISH-<snowflake> sourceFileCount=2 totalRows=1 pageSize=50
vo.file fileId=2001 fileKey=uploads/a.xlsx shopName=shop-a matched=true status=PENDING totalRows=1 percent=0 errorMessage=null
vo.file fileId=2002 fileKey=uploads/b.xlsx shopName=shop-b matched=false status=FAILED totalRows=0 percent=100 errorMessage=店铺未匹配到紫鸟索引
== 匹配服务抛异常:全文件失败 ⇒ 任务直接 FAILED 并封口 ==
tx.begin
task.insert taskNo=PUBLISH-<snowflake> moduleType=PUBLISH status=FAILED taskMode=PYTHON_QUEUE sourceFileCount=1 successFileCount=0 failedFileCount=1 userId=7 createdBy=user:7 deviceId=d errorMessage=全部文件解析或店铺匹配失败 finishedAtSet=true requestJson.keys=[files,fileKey,originalFilename,relativePath,user_id,publish_country,sync_countries] requestJson.digest=9982fc0a2d4f resultJson={"ownerInstanceId":"node-A"}
file.insert taskId=1001 fileId=2001 fileKey=uploads/a.xlsx sourceFilename=shop-a.xlsx relativePath=a.xlsx shopName=shop-a matched=0 shopId=null matchedUserId=null platform=null companyName=null matchStatus=PENDING matchMessage=紫鸟索引不可用 status=FAILED totalRows=0 processedRows=0 errorMessage=紫鸟索引不可用 finishedAtSet=true createdAtEqualsTaskNow=true
result.insert taskId=1001 moduleType=PUBLISH sourceFilename=shop-a.xlsx sourceFileUrl=uploads/a.xlsx resultContentType=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet rowCount=0 success=0 errorMessage=全部文件解析或店铺匹配失败 userId=7 createdAtEqualsTaskNow=true
tx.commit
vo: taskId=1001 taskNo=PUBLISH-<snowflake> sourceFileCount=1 totalRows=0 pageSize=50
vo.file fileId=2001 fileKey=uploads/a.xlsx shopName=shop-a matched=false status=FAILED totalRows=0 percent=100 errorMessage=紫鸟索引不可用
== 解析出 0 行:不调 insertBatch,但文件仍 PENDING、任务仍建起来 ==
tx.begin
task.insert taskNo=PUBLISH-<snowflake> moduleType=PUBLISH status=PENDING taskMode=PYTHON_QUEUE sourceFileCount=1 successFileCount=0 failedFileCount=0 userId=7 createdBy=user:7 deviceId=d errorMessage=null finishedAtSet=false requestJson.keys=[files,fileKey,originalFilename,relativePath,user_id,publish_country,sync_countries] requestJson.digest=0f201eecd7e5 resultJson={"ownerInstanceId":"node-A"}
file.insert taskId=1001 fileId=2001 fileKey=uploads/empty.xlsx sourceFilename=shop-a.xlsx relativePath=empty.xlsx shopName=shop-a matched=1 shopId=shop-9 matchedUserId=42 platform=amazon companyName=ACME 有限公司 matchStatus=MATCHED matchMessage= status=PENDING totalRows=0 processedRows=0 errorMessage=null finishedAtSet=false createdAtEqualsTaskNow=true
result.insert taskId=1001 moduleType=PUBLISH sourceFilename=shop-a.xlsx sourceFileUrl=uploads/empty.xlsx resultContentType=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet rowCount=0 success=0 errorMessage=null userId=7 createdAtEqualsTaskNow=true
tx.commit
vo: taskId=1001 taskNo=PUBLISH-<snowflake> sourceFileCount=1 totalRows=0 pageSize=50
vo.file fileId=2001 fileKey=uploads/empty.xlsx shopName=shop-a matched=true status=PENDING totalRows=0 percent=0 errorMessage=null
== 行含 null:计数含 null 而落库跳 null,品牌落库前过 BrandLabel.strip ==
tx.begin
task.insert taskNo=PUBLISH-<snowflake> moduleType=PUBLISH status=PENDING taskMode=PYTHON_QUEUE sourceFileCount=1 successFileCount=0 failedFileCount=0 userId=7 createdBy=user:7 deviceId=d errorMessage=null finishedAtSet=false requestJson.keys=[files,fileKey,originalFilename,relativePath,user_id,publish_country,sync_countries] requestJson.digest=f87ffd176e5e resultJson={"ownerInstanceId":"node-A"}
file.insert taskId=1001 fileId=2001 fileKey=uploads/null-row.xlsx sourceFilename=shop-a.xlsx relativePath=n.xlsx shopName=shop-a matched=1 shopId=shop-9 matchedUserId=42 platform=amazon companyName=ACME 有限公司 matchStatus=MATCHED matchMessage= status=PENDING totalRows=3 processedRows=0 errorMessage=null finishedAtSet=false createdAtEqualsTaskNow=true
item.insertBatch count=2 taskId=1001 fileId=2001 rowIndex=[1,2] asins=[B001,B002] brands=[NIKE: X,李宁] itemCreatedAtEqualsTaskNow=false
result.insert taskId=1001 moduleType=PUBLISH sourceFilename=shop-a.xlsx sourceFileUrl=uploads/null-row.xlsx resultContentType=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet rowCount=3 success=0 errorMessage=null userId=7 createdAtEqualsTaskNow=true
tx.commit
vo: taskId=1001 taskNo=PUBLISH-<snowflake> sourceFileCount=1 totalRows=3 pageSize=50
vo.file fileId=2001 fileKey=uploads/null-row.xlsx shopName=shop-a matched=true status=PENDING totalRows=3 percent=0 errorMessage=null
== 建单被拒的七格:事务未开、一次库都不碰 ==
request=null -> BusinessException: 请求不能为空
userId=null -> BusinessException: user_id 不合法
userId=0 -> BusinessException: user_id 不合法
files=null -> BusinessException: 请先上传 Excel 文件
files=空 -> BusinessException: 请先上传 Excel 文件
publishCountry=空白 -> BusinessException: 发布国家不能为空
fileKey 重复 -> BusinessException: 上传文件重复: shop-a.xlsx
events=0(重复 fileKey 那格已 prepare 过首文件,但落库与事务都未开始)