result = new LinkedHashMap<>();
+ result.put("object_key", objectKey);
+ result.put("file_url", ossStorageService.getWorkbenchClientDownloadUrl(objectKey));
+ result.put("file_name", normalizedName);
+ result.put("version", normalizedVersion);
+ result.put("sha256", completed.sha256());
+ return result;
+ }
+
+ /**
+ * 清理已上传但未登记的包对象(confirm 失败后的补偿):数据库已有同 key 记录时拒绝,
+ * 避免管理员误删线上正在使用的安装包。
+ */
+ public void cleanupUnconfirmedObject(String objectKey) {
+ if (objectKey == null || !objectKey.startsWith(OBJECT_KEY_PREFIX)) {
+ throw new BusinessException("非法的对象路径");
+ }
+ if (findByObjectKey(objectKey) != null) {
+ throw new BusinessException("该对象已登记,不能按未确认清理");
+ }
+ ossStorageService.removeWorkbenchClientObject(objectKey);
+ log.info("[workbench-client] 已清理未登记的包对象 objectKey={}", objectKey);
+ }
+
+ /**
+ * 放弃分片上传:删分片会话;若已拼装并转存过对象(confirm 失败场景),一并清理未登记对象。
+ * 会话不存在/对象已登记都不算失败——补偿清理要尽力而为,不能反过来挡住重传。
+ */
+ public void abortChunkedPackage(String uploadId, String objectKey) {
+ try {
+ chunkedUploadService.abort(uploadId);
+ } catch (BusinessException ex) {
+ log.info("[workbench-client] 分片会话已不存在(可能已完成) uploadId={}", uploadId);
+ }
+ if (objectKey != null && objectKey.startsWith(OBJECT_KEY_PREFIX)) {
+ try {
+ cleanupUnconfirmedObject(objectKey);
+ } catch (BusinessException ex) {
+ log.warn("[workbench-client] 清理未登记对象失败 objectKey={} reason={}",
+ objectKey, ex.getMessage());
+ }
+ }
+ }
+
+ private String newObjectKey(String normalizedVersion) {
+ return OBJECT_KEY_PREFIX
+ + OBJECT_NAME_FORMATTER.format(LocalDateTime.now())
+ + "-" + UUID.randomUUID().toString().replace("-", "")
+ + "-" + safeVersionKey(normalizedVersion) + ".zip";
+ }
+
/**
* 直传确认:校验对象存在、大小上限、版本号与对象名一致,服务端复算 sha256 后落库。
* sha256 为空或长度不对直接拒绝——宁可让管理员重传,也不让客户端拿到没有锚点的包。
diff --git a/backend-java/src/main/resources/application.yml b/backend-java/src/main/resources/application.yml
index 3e120b84a..3816fd357 100644
--- a/backend-java/src/main/resources/application.yml
+++ b/backend-java/src/main/resources/application.yml
@@ -212,6 +212,16 @@ aiimage:
source-retention-hours: ${AIIMAGE_STORAGE_SOURCE_RETENTION_HOURS:24}
result-retention-hours: ${AIIMAGE_STORAGE_RESULT_RETENTION_HOURS:24}
transient-payload-retention-hours: ${AIIMAGE_STORAGE_TRANSIENT_PAYLOAD_RETENTION_HOURS:72}
+ # 大文件分片上传通道(AC-17/S1-F3):浏览器分片 → 服务端拼装 → 复算 sha256 后按普通临时件落库。
+ # 这三键是闸门值而不是调优参数:放宽等于同时放大临时盘驻留与拼装阶段的耗时上限。
+ file:
+ chunk-upload:
+ # 单个会话允许的总字节(默认 2GiB):init 与逐片累计都要过这道闸,超限直接拒绝
+ max-total-bytes: ${AIIMAGE_FILE_CHUNK_UPLOAD_MAX_TOTAL_BYTES:2147483648}
+ # 允许的分片数上限(默认 4096):与前端 8MB/片相乘即体积的第二道闸
+ max-parts: ${AIIMAGE_FILE_CHUNK_UPLOAD_MAX_PARTS:4096}
+ # 未完成会话与残留片的驻留小时数:超时由清理动作回收,避免断掉的上传永久占盘
+ stale-hours: ${AIIMAGE_FILE_CHUNK_UPLOAD_STALE_HOURS:24}
temp-dir:
retention-hours: ${AIIMAGE_TEMP_DIR_RETENTION_HOURS:24}
capacity-plan:
diff --git a/backend-java/src/test/java/com/nanri/aiimage/config/CatchSilenceRatchetTest.java b/backend-java/src/test/java/com/nanri/aiimage/config/CatchSilenceRatchetTest.java
index 80d1fb4ed..e89631636 100644
--- a/backend-java/src/test/java/com/nanri/aiimage/config/CatchSilenceRatchetTest.java
+++ b/backend-java/src/test/java/com/nanri/aiimage/config/CatchSilenceRatchetTest.java
@@ -57,7 +57,9 @@ class CatchSilenceRatchetTest {
// 10-28 V179 采集被过滤行追溯抬 579 -> 582(审计件三枚:逐批插入容错/回流簿记容错/尾 sheet 降级,
// 逐处记名见 STRICT_TOTAL 上方注释)。
// 10-28 Phase 3 抬 582 -> 585(心跳降级一枚 + 优雅停机两枚中断恢复,逐处记名见 STRICT_TOTAL 上方注释)。
- static final int GIVEN_NOT_RETHROW = 585;
+ // 10-29 Phase 4D 抬 585 -> 591(AC-17 分片通道六枚 LOG_ONLY:清理/收尾失败不得盖掉主错误,
+ // 逐处记名见 STRICT_TOTAL 上方注释;EMPTY 一格没涨)。
+ static final int GIVEN_NOT_RETHROW = 591;
static final int GIVEN_LOG_ONLY = 249;
static final int GIVEN_EMPTY = 56;
@@ -211,8 +213,29 @@ class CatchSilenceRatchetTest {
*
{@code TaskFileJobConfig.videoQueueExecutor} 一枚:信号量 acquire 被中断只恢复中断标记
* (S1-B2 视频独立许可,照抄 taskQueueExecutor 的既有形状)。
*
+ * 10-29 Phase 4D(AC-17/S1-F3 大文件分片通道)抬 total 1034 -> 1045,11 枚逐处记名。
+ * 这一批是"新增通道"而不是"给既有出口补兜":整条 {@code ChunkedUploadService} 与
+ * {@code WorkbenchClientPackageService} 的分片方法都是新落点,Java 的受检 {@code IOException}
+ * 使每一段磁盘动作都必须有自己的出口,形状与既有件同口径:
+ *
+ * - RETHROW 五枚——{@code ChunkedUploadService.init}(建会话目录失败:先 {@code deleteQuietly}
+ * 再抛 {@code BusinessException},不留半个会话)、{@code complete}(拼装中途失败:删掉半成品
+ * 后原样 {@code throw ex},绝不产出半个文件)、{@code readMeta}(元数据损坏直接抛,
+ * 让调用方重新 init 而不是按坏元数据继续拼)、{@code sha256Digest}(JVM 无 SHA-256 属环境级
+ * 不可能,抛 {@code IllegalStateException} 带 cause)、{@code WorkbenchClientPackageService
+ * .completeChunkedPackage}(拼装 IOException 翻成业务文案,500 变可读错误)。
+ * - LOG_ONLY 六枚,块体各只有一句带锚点的 log,误差方向都是"清理/收尾失败不得盖掉主错误"——
+ * {@code ChunkedUploadService.cleanupStaleSessions} 内层(单条目时间戳读不出,本轮跳过该条)
+ * 与外层({@code Files.list} 失败,整轮清理放弃但不拦新会话)、
+ * {@code deleteQuietly} 的逐片删除与整体遍历两枚(残留交给过期回收),
+ * {@code WorkbenchClientPackageService.abortChunkedPackage} 的两枚(会话已不存在只 INFO;
+ * 未登记对象清理失败 WARN 带 objectKey,登记成功的对象后端会拒绝清理,不该在这里改口)。
+ * - EMPTY 一格没涨:三处原本写成 {@code catch (IOException ignored) { /* 尽力清理 *\/ }} 的
+ * 空体已按 10-26 那批的先例改成 WARN 带 path——空体是三类高危出口里最贵的一种,
+ * 这里宁可让 {@code STRICT_LOG_ONLY} 涨六格,也不给"删除失败连日志都不留"开门。
+ *
*/
- static final int STRICT_TOTAL = 1034;
+ static final int STRICT_TOTAL = 1045;
/**
* 重抛型 catch 的**下限**(不是上限):本轮把两处吞异常改成重抛之后实测 388。
* 这一格只能涨不能跌——它是"异常会往外走"的总量,把它钉成"只许减"就等于拦着别人修吞异常。
@@ -322,8 +345,13 @@ class CatchSilenceRatchetTest {
* 块体 log.warn 带 taskId/moduleType)、{@code TaskFileJobConfig.taskQueueVirtualThreadExecutor}
* 的 {@code shutdown()} 与 {@code TaskFileJobConfig.videoQueueExecutor}(S1-B6/S1-B2,
* {@code InterruptedException} 只恢复中断标记),逐处记名见 STRICT_TOTAL 上方注释。
+ * 10-29 Phase 4D 再抬 585 -> 591(AC-17 分片通道六枚 LOG_ONLY,逐处记名见 STRICT_TOTAL 上方注释):
+ * {@code ChunkedUploadService.cleanupStaleSessions} 内外两枚、{@code deleteQuietly} 逐片与整体两枚、
+ * {@code WorkbenchClientPackageService.abortChunkedPackage} 的「会话已不存在」INFO 与
+ * 「未登记对象清理失败」WARN 两枚。六枚的误差方向都是「清理/收尾失败不得盖掉主错误」,
+ * 主错误由外层重抛;本批 EMPTY 一格没涨(原先三枚空体已按 10-26 先例改成带 path 的 WARN)。
*/
- static final int STRICT_NOT_RETHROW = 585;
+ static final int STRICT_NOT_RETHROW = 591;
/**
* 10-17 抬 172 -> 173,出处就是上面点名过的 {@code TaskHeartbeatLivenessService.stamp()}:
* 块体只有「取到 key 名 + log.warn」一句,写心跳证据失败时既不重试也不抛出——
@@ -347,8 +375,13 @@ class CatchSilenceRatchetTest {
* 块体只有一句带 {@code [collect-data]} 锚点的 WARN(taskId+chunk+err),坏批点名后其余批照常
* 落库。同批另两处({@code markResolved} 追加 return、{@code writeFilteredSheet} 置 incomplete 位)
* 因块内多一句只进 NOT_RETHROW。
+ * 10-29 Phase 4D 抬 182 -> 188(AC-17 分片通道六枚,逐处记名见 STRICT_TOTAL 上方注释):
+ * {@code ChunkedUploadService.cleanupStaleSessions} 内外两枚、{@code deleteQuietly} 逐片与整体两枚
+ * (这四枚原本是 {@code catch (IOException ignored)} 空体,按 10-26 那批先例改成带 path 的 WARN,
+ * 是「空体换 LOG_ONLY」的迁移而不是新增沉默),加上
+ * {@code WorkbenchClientPackageService.abortChunkedPackage} 的 INFO 与 WARN 两枚。
*/
- static final int STRICT_LOG_ONLY = 182; // 严格口径:块内每条顶层语句都是 log 调用才算
+ static final int STRICT_LOG_ONLY = 188; // 严格口径:块内每条顶层语句都是 log 调用才算
static final int STRICT_EMPTY = 56;
/**
diff --git a/backend-java/src/test/java/com/nanri/aiimage/modules/clienterror/controller/ClientErrorReportControllerTest.java b/backend-java/src/test/java/com/nanri/aiimage/modules/clienterror/controller/ClientErrorReportControllerTest.java
new file mode 100644
index 000000000..9e7040186
--- /dev/null
+++ b/backend-java/src/test/java/com/nanri/aiimage/modules/clienterror/controller/ClientErrorReportControllerTest.java
@@ -0,0 +1,85 @@
+package com.nanri.aiimage.modules.clienterror.controller;
+
+import com.nanri.aiimage.common.api.ApiResponse;
+import com.nanri.aiimage.common.exception.BusinessException;
+import com.nanri.aiimage.common.model.entity.AdminUserEntity;
+import com.nanri.aiimage.common.security.AdminAuthSupport;
+import jakarta.servlet.http.HttpServletRequest;
+import org.junit.jupiter.api.Test;
+
+import java.util.HashMap;
+import java.util.Map;
+
+import static org.assertj.core.api.Assertions.assertThat;
+import static org.assertj.core.api.Assertions.assertThatThrownBy;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.when;
+
+/**
+ * 后管浏览器错误上报口(S1-F2/AC-16)的鉴权与体量闸门。
+ *
+ * 两条底线:① 这是写入口,匿名请求(sendBeacon 没带管理员会话)必须被拒——与 AC-8
+ * 「匿名写端点要凭据」同一口径,否则任何人都能往服务端日志里灌任意文本;
+ * ② 报文体一律逐字段截断,堆栈不许把整条日志撑爆,也不许原样回显给调用方。
+ */
+class ClientErrorReportControllerTest {
+
+ private final AdminAuthSupport adminAuthSupport = mock(AdminAuthSupport.class);
+ private final HttpServletRequest request = mock(HttpServletRequest.class);
+
+ private ClientErrorReportController newController() {
+ return new ClientErrorReportController(adminAuthSupport);
+ }
+
+ private void loginAsAdmin() {
+ AdminUserEntity operator = new AdminUserEntity();
+ operator.setId(11L);
+ when(adminAuthSupport.requireAdmin(any())).thenReturn(operator);
+ }
+
+ @Test
+ void 匿名上报必须被拒() {
+ when(adminAuthSupport.requireAdmin(any())).thenThrow(new BusinessException(401, "未登录"));
+
+ assertThatThrownBy(() -> newController().report(request, Map.of("kind", "window-error")))
+ .isInstanceOf(BusinessException.class)
+ .hasMessageContaining("未登录");
+ }
+
+ @Test
+ void 合法会话上报成功且只回一个录制标记() {
+ loginAsAdmin();
+
+ ApiResponse