diff --git a/backend-java/src/test/java/com/nanri/aiimage/modules/publish/service/support/PublishSubmitResultSnapshotTest.java b/backend-java/src/test/java/com/nanri/aiimage/modules/publish/service/support/PublishSubmitResultSnapshotTest.java
new file mode 100644
index 000000000..8941afec4
--- /dev/null
+++ b/backend-java/src/test/java/com/nanri/aiimage/modules/publish/service/support/PublishSubmitResultSnapshotTest.java
@@ -0,0 +1,792 @@
+package com.nanri.aiimage.modules.publish.service.support;
+
+import com.baomidou.mybatisplus.core.MybatisConfiguration;
+import com.baomidou.mybatisplus.core.conditions.AbstractWrapper;
+import com.baomidou.mybatisplus.core.metadata.TableInfoHelper;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.nanri.aiimage.common.exception.BusinessException;
+import com.nanri.aiimage.common.service.DistributedJobLockService;
+import com.nanri.aiimage.config.InstanceMetadata;
+import com.nanri.aiimage.modules.file.service.LocalFileStorageService;
+import com.nanri.aiimage.modules.file.service.oss.OssStorageService;
+import com.nanri.aiimage.modules.publish.mapper.PublishFileMapper;
+import com.nanri.aiimage.modules.publish.mapper.PublishItemMapper;
+import com.nanri.aiimage.modules.publish.model.dto.PublishResultFileDto;
+import com.nanri.aiimage.modules.publish.model.dto.PublishRowDto;
+import com.nanri.aiimage.modules.publish.model.dto.PublishSubmitResultRequest;
+import com.nanri.aiimage.modules.publish.model.entity.PublishFileEntity;
+import com.nanri.aiimage.modules.publish.model.entity.PublishItemEntity;
+import com.nanri.aiimage.modules.publish.service.PublishTaskService;
+import com.nanri.aiimage.modules.publish.service.PublishWorkbookService;
+import com.nanri.aiimage.modules.task.mapper.FileResultMapper;
+import com.nanri.aiimage.modules.task.mapper.FileTaskMapper;
+import com.nanri.aiimage.modules.task.mapper.TaskChunkMapper;
+import com.nanri.aiimage.modules.task.mapper.TaskScopeStateMapper;
+import com.nanri.aiimage.modules.task.model.entity.FileResultEntity;
+import com.nanri.aiimage.modules.task.model.entity.FileTaskEntity;
+import com.nanri.aiimage.modules.task.model.entity.TaskChunkEntity;
+import com.nanri.aiimage.modules.task.model.entity.TaskScopeStateEntity;
+import com.nanri.aiimage.modules.task.service.TaskDistributedLockService;
+import com.nanri.aiimage.modules.task.service.TaskFileJobService;
+import com.nanri.aiimage.modules.task.service.TaskHeartbeatPositionService;
+import com.nanri.aiimage.modules.task.service.TaskProgressLightAssembler;
+import com.nanri.aiimage.modules.task.service.TransientPayloadStorageService;
+import com.nanri.aiimage.modules.ziniao.service.ZiniaoShopSwitchService;
+import org.apache.ibatis.builder.MapperBuilderAssistant;
+import org.junit.jupiter.api.BeforeAll;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.condition.EnabledIfEnvironmentVariable;
+import org.mockito.stubbing.Answer;
+import org.springframework.transaction.TransactionStatus;
+import org.springframework.transaction.support.TransactionSynchronization;
+import org.springframework.transaction.support.TransactionSynchronizationManager;
+import org.springframework.transaction.support.TransactionTemplate;
+
+import java.io.File;
+import java.nio.charset.StandardCharsets;
+import java.nio.file.Files;
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+import java.util.function.Consumer;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.anyInt;
+import static org.mockito.ArgumentMatchers.anyList;
+import static org.mockito.ArgumentMatchers.anyLong;
+import static org.mockito.ArgumentMatchers.anyString;
+import static org.mockito.Mockito.doAnswer;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.when;
+
+/**
+ * 上架结果回传落库(段 3)的现网行为快照——3D 余下那一支({@code publish})接底座的护身符。
+ *
+ *
为什么先补这一支。{@code publish} 现有唯一快照 {@code batch-loading-snapshot.txt}
+ * 锁的是建单与批量加载,{@code submitResult} 出结果段一行没打。3D 要动的正是那一段里的准入
+ * (先取锁后加载、{@code requireTaskId} 同形)、终态判定(本支的 SUCCESS 是静默短路、
+ * FAILED 抛「任务已失败,拒绝继续回传」,两支都不是底座那两种形状)与组装 job 挂接。
+ *
+ *
这支的形状与前面六支不同的三处,流水里都有对应格子钉着。
+ * ①任务被加载两次({@code prepareResultSubmission} 与 {@code submitResultLocked} 各一次
+ * {@code requireTask}),而取锁在两次之前——与 collectdata 的「预检在取锁之前」正好相反;
+ * ②载荷删除走两条路:prepare 抛异常时删全量,事务之后再删「未提交」那一份(要减掉
+ * committedPayloads),而 {@code deleteUncommittedPayloads} 删之前还会先查一次
+ * {@code taskChunkMapper.selectCount} 问「这条指针还被分片行引用吗」——引用中就跳过;
+ * ③事务提交后的清理本身也在流水里:全部文件失败 ⇒ {@code cleanupAfterCommit=true} ⇒
+ * 出事务后删 chunk 行与 scope 行再删载荷,而清理自己抛异常是被 catch 吞掉只打 warn 的。
+ *
+ *
事务替身为什么要把 synchronization 开起来。{@code deletePayloadsAfterCommit} 判的是
+ * {@code TransactionSynchronizationManager.isSynchronizationActive()}:真 {@code TransactionTemplate}
+ * 在事务里会激活它、把远端删除推到 afterCommit。裸跑回调会让删除早于事务返回落到另一个位置,
+ * 快照就记成了现网没有的顺序。这里照 Spring 的做法 init→回调→afterCommit→clear,
+ * 并在 {@code finally} 里清干净(thread-local,漏一次就污染后面所有用例)。
+ *
+ *
替身只实现这条链真吃到的部分:任务行/文件行/分片行/作用域行都是内存活实体
+ * (重读看得见上一次写入),分片查询按 wrapper 绑定值(scopeHash 与 chunkIndex)匹配而不是
+ * 「任意入参返回同一只」——后者会把入参校验整格搬进测试(3C 刚踩过)。长内容(分片载荷、
+ * stateJson)只进长度与 sha256 前 12 位;时钟、雪花 id、OSS 直链、实例 id 不进快照。
+ *
+ * golden:src/test/resources/publish/golden/submit-result-snapshot.txt
+ * 重新生成:{@code SHUFU_SNAPSHOT_WRITE=true mvn -o test -Dtest=PublishSubmitResultSnapshotTest}
+ */
+class PublishSubmitResultSnapshotTest {
+
+ private static final File GOLDEN_SUBMIT =
+ new File("src/test/resources/publish/golden/submit-result-snapshot.txt");
+ private static final long TASK_ID = 1001L;
+ private static final long FILE_ID = 9101L;
+ private static final long RESULT_ID = 2001L;
+ private static final long USER_ID = 7L;
+
+ @BeforeAll
+ static void initLambdaCache() {
+ MapperBuilderAssistant assistant = new MapperBuilderAssistant(new MybatisConfiguration(), "");
+ TableInfoHelper.initTableInfo(assistant, FileTaskEntity.class);
+ TableInfoHelper.initTableInfo(assistant, FileResultEntity.class);
+ TableInfoHelper.initTableInfo(assistant, TaskChunkEntity.class);
+ TableInfoHelper.initTableInfo(assistant, TaskScopeStateEntity.class);
+ TableInfoHelper.initTableInfo(assistant, PublishFileEntity.class);
+ TableInfoHelper.initTableInfo(assistant, PublishItemEntity.class);
+ }
+
+ // ------------------------------------------------------------------
+ // 现网副作用替身
+ // ------------------------------------------------------------------
+
+ private static final class Fixture {
+ private final List events = new ArrayList<>();
+ private final Map files = new LinkedHashMap<>();
+ private final List chunks = new ArrayList<>();
+ private final Map payloadBody = new LinkedHashMap<>();
+ private FileTaskEntity task;
+ private FileResultEntity result;
+ private TaskScopeStateEntity scope;
+ private boolean rustfsEnabled = true;
+ private boolean rustfsPointer = true;
+ private boolean lockAvailable = true;
+ private long itemCount = 0L;
+ private int jobEnqueues = 0;
+ private int payloadDeletes = 0;
+ /** 留给「清理自身抛异常」那一格重新打桩用(mock 在 {@code newService} 里就地创建,不存住就够不着)。 */
+ private TaskChunkMapper chunkMapper;
+ }
+
+ private static FileTaskEntity task(String status) {
+ FileTaskEntity task = new FileTaskEntity();
+ task.setId(TASK_ID);
+ task.setModuleType("PUBLISH");
+ task.setStatus(status);
+ task.setTaskMode("PYTHON_QUEUE");
+ task.setUserId(USER_ID);
+ task.setTaskNo("PUBLISH-1");
+ task.setSourceFileCount(1);
+ task.setSuccessFileCount(0);
+ task.setFailedFileCount(0);
+ task.setResultJson("{\"ownerInstanceId\":\"node-A\"}");
+ return task;
+ }
+
+ private static PublishFileEntity file(Long id, String status) {
+ PublishFileEntity file = new PublishFileEntity();
+ file.setId(id);
+ file.setTaskId(TASK_ID);
+ file.setFileKey("uploads/key-" + id + ".xlsx");
+ file.setSourceFilename("listing-" + id + ".xlsx");
+ file.setStatus(status);
+ file.setTotalRows(0);
+ file.setProcessedRows(0);
+ return file;
+ }
+
+ private static FileResultEntity resultRow() {
+ FileResultEntity row = new FileResultEntity();
+ row.setId(RESULT_ID);
+ row.setTaskId(TASK_ID);
+ row.setModuleType("PUBLISH");
+ row.setSourceFilename("PUBLISH-1");
+ row.setRowCount(0);
+ row.setSuccess(0);
+ row.setUserId(USER_ID);
+ return row;
+ }
+
+ private static TaskChunkEntity storedChunk(int chunkIndex, int chunkTotal, String pointer, String payloadHash) {
+ TaskChunkEntity chunk = new TaskChunkEntity();
+ chunk.setId((long) (5000 + chunkIndex));
+ chunk.setTaskId(TASK_ID);
+ chunk.setModuleType("PUBLISH");
+ chunk.setScopeKey("file:" + FILE_ID);
+ chunk.setScopeHash("scope-hash-" + FILE_ID);
+ chunk.setChunkIndex(chunkIndex);
+ chunk.setChunkTotal(chunkTotal);
+ chunk.setPayloadJson(pointer);
+ chunk.setPayloadHash(payloadHash);
+ return chunk;
+ }
+
+ private static PublishRowDto row(String asin, String country) {
+ PublishRowDto row = new PublishRowDto();
+ row.setAsin(asin);
+ row.setCountry(country);
+ row.setBrand("brand-" + asin);
+ row.setPrice("19.90");
+ row.setStatus("ACTIVE");
+ return row;
+ }
+
+ private static PublishResultFileDto fileDto(Long fileId, Integer chunkIndex, Integer chunkTotal,
+ String error, PublishRowDto... rows) {
+ PublishResultFileDto dto = new PublishResultFileDto();
+ dto.setFileId(fileId);
+ dto.setChunkIndex(chunkIndex);
+ dto.setChunkTotal(chunkTotal);
+ dto.setError(error);
+ dto.setRows(new ArrayList<>(List.of(rows)));
+ return dto;
+ }
+
+ private static PublishSubmitResultRequest request(Long userId, PublishResultFileDto... files) {
+ PublishSubmitResultRequest request = new PublishSubmitResultRequest();
+ request.setUserId(userId);
+ request.setFiles(new ArrayList<>(List.of(files)));
+ return request;
+ }
+
+ // ------------------------------------------------------------------
+ // 装配
+ // ------------------------------------------------------------------
+
+ private static PublishTaskService newService(Fixture f) {
+ FileTaskMapper fileTaskMapper = mock(FileTaskMapper.class);
+ FileResultMapper fileResultMapper = mock(FileResultMapper.class);
+ PublishFileMapper publishFileMapper = mock(PublishFileMapper.class);
+ PublishItemMapper publishItemMapper = mock(PublishItemMapper.class);
+ TaskChunkMapper taskChunkMapper = mock(TaskChunkMapper.class);
+ TaskScopeStateMapper taskScopeStateMapper = mock(TaskScopeStateMapper.class);
+ TaskFileJobService taskFileJobService = mock(TaskFileJobService.class);
+ TaskDistributedLockService lockService = mock(TaskDistributedLockService.class);
+ TransientPayloadStorageService payloadStorage = mock(TransientPayloadStorageService.class);
+ TransactionTemplate transactionTemplate = mock(TransactionTemplate.class);
+ InstanceMetadata instanceMetadata = mock(InstanceMetadata.class);
+ // 真 ObjectMapper:这条链上有 writeValueAsString(载荷)/readValue(合并分片)/
+ // readTree(resultJson 里的 ownerInstanceId),拿替身会把三段全短路。
+ ObjectMapper objectMapper = new ObjectMapper();
+
+ when(instanceMetadata.getInstanceId()).thenReturn("node-A");
+ f.chunkMapper = taskChunkMapper;
+
+ when(lockService.acquire(anyString(), anyLong())).thenAnswer(invocation -> {
+ f.events.add("lock.acquire taskId=" + invocation.getArgument(1));
+ return f.lockAvailable ? mock(TaskDistributedLockService.LockHandle.class) : null;
+ });
+ when(lockService.acquire(anyString(), anyLong(), anyLong()))
+ .thenAnswer(invocation -> mock(TaskDistributedLockService.LockHandle.class));
+
+ when(fileTaskMapper.selectById(any())).thenAnswer(invocation -> {
+ // 按主键取:写 `return f.task` 会让「taskId 非法/不存在的任务」那两格证的是替身形状。
+ Object id = invocation.getArgument(0);
+ FileTaskEntity loaded = Objects.equals(id, TASK_ID) ? f.task : null;
+ f.events.add("task.load id=" + id + " status=" + dash(loaded == null ? null : loaded.getStatus())
+ + " module=" + dash(loaded == null ? null : loaded.getModuleType())
+ + " userId=" + dash(loaded == null ? null : loaded.getUserId()));
+ return loaded;
+ });
+ doAnswer(recordTaskUpdate(f)).when(fileTaskMapper).updateById(any(FileTaskEntity.class));
+
+ when(publishFileMapper.selectById(any())).thenAnswer(invocation -> {
+ Object id = invocation.getArgument(0);
+ PublishFileEntity loaded = f.files.get(id);
+ f.events.add("file.selectById id=" + id
+ + " status=" + dash(loaded == null ? null : loaded.getStatus()));
+ return loaded;
+ });
+ when(publishFileMapper.selectOne(any())).thenAnswer(invocation -> {
+ Collection