From 0586df2df08ce3ae228d547c4a473d6fe4192db8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=BB=84=E8=87=AA=E8=BE=BE?= <980324341@qq.com> Date: Thu, 29 Oct 2026 13:47:21 +0800 Subject: [PATCH] =?UTF-8?q?feat(phase-4):=20AC-16/17/18=20=E5=89=8D?= =?UTF-8?q?=E7=AB=AF=E7=99=BB=E5=BD=95=E6=80=81=E4=B8=8E=E5=88=86=E7=89=87?= =?UTF-8?q?=E4=B8=8A=E4=BC=A0=E3=80=81=E5=90=8E=E7=AE=A1=E5=8C=85=E4=BD=93?= =?UTF-8?q?=E4=B8=8E=E7=AB=9E=E6=80=81=E9=97=A8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit AC-16(S1-F1/S1-F2) - frontend-vue ensureAuth:清态前先判 isAuthError——弱网/超时/5xx 不再把人踢回登录页; http.ts 的 onResponseRejected 给错误打鉴权标记(HTTP 401 与业务 401/4011 都算), 纯网络错误保留底层文案供调用方区分"断网"与"掉登录";clearLocalSession 导出复用。 - admin 全局错误兜底:main.ts 装 app.config.errorHandler(首屏就崩也接得住), window error / unhandledrejection 由 App.vue setup 调 useGlobalErrorReporting() 接线, 卸载出口在 onBeforeUnmount 摘监听与提示定时器(后管的 timer-cleanup-pairing 尺子要求 "注册点所在文件找得回反注册 + 卸载钩子",故接线必须在组件作用域,不在 main.ts)。 上报体只带 kind/message/stack/route/ts 并过脱敏(Bearer、JWT 三段式、query 里疑似 token/key/secret 的取值一律打码),凭据零容忍;服务端新增 /api/admin/client-errors(requireAdmin,字段截断 2000 后 WARN 落日志,不落库)。 AC-17(S1-F3) - 后端新增分片通道 ChunkedUploadService(init/part/status/complete/abort):8MB/片、 同片重复上传幂等覆盖、流式拼装复算 sha256、超限与缺片直接拒绝、24h 过期回收; FileUploadController 暴露 /api/files/chunk/**,LocalFileStorageService 加 saveTempFileFromFile(同一套扩展名黑名单与 fileKey 索引);三键显式写进 application.yml (不进"只在代码默认值里"的名单)。 - 工作台安装包 93MB:WorkbenchClientPackageService 走同一分片通道转存 client 桶 (objectKey 写进会话 purpose,拼装时逐字匹配,防借分片接口覆盖已发布包), confirm 失败带 cleanupUnconfirmedObject 补偿清理未登记对象;后管 ≤64MB 仍直传预签名 PUT。 - 用户端 upload.ts:大文件分片 + 逐片重试 + 进度回调,超时按体积给(不再固定 120s); 断点探测失败不再静默按"全缺"重传(catch-silence 棘轮因此一格没涨,blocks 300→301 已记名)。 AC-18(P1-F1/P1-F2/P1-F4/S1-F4) - 后管 manualChunks 摘掉 element-plus(按需引入已在 src/plugins/element.ts 生效): 实测构建产物已无 element-plus 独立 chunk,index.html 只 modulepreload vue 块。 - UsersPage/DeviceLogsPage 接 createLatestRequestGate,旧响应不再覆盖新页; 用户端新增 useServerTablePaging(只驻留当前页 + 自带竞态门 + 失败给原因), 挂载用例 3 例钉住"翻页重取/旧响应作废/失败可见"。 - DeliveryVideoWorkspace 两处轮询接 document.visibilityState,隐藏标签页暂停。 激活 Phase 0 预置契约 7 例(用户端 5 + 后管 5,共 12 例;其中 AC-16 后管两支按"接线在组件作用域" 的口径改写并把判据加强到反注册配对 + 根组件接线,见蓝图 §5)。 门禁读数:后端 mvn -o test-compile rc=0,CatchSilenceRatchetTest 9 例绿(total 1034→1045、 notRethrow 585→591、logOnly 182→188 逐处记名,EMPTY 未涨)、ChunkedUploadServiceTest 8 例、 WorkbenchClientPackageServiceTest 21 例、ClientErrorReportControllerTest 4 例;后管 1848 例 + mount 33 例 + vue-tsc + build 全绿;用户端 955 例 + mount 30 例 + vue-tsc + build 全绿。 真机:OssWorkbenchClientLiveVerificationTest 以线上 MinIO 实测 PUT→stat→sha256→presign→删除 全链 1 例绿(凭据只走环境变量,不落任何文件)。 ⚠ 按 pathspec 只圈本轮文件:application.yml 用索引手术只提交分片三键那一格,他人 「PENDING 不再按 2 小时判死」的 StaleTaskRepairService/ClientTaskPullSpi/application.yml 注释件与 useLiveTaskBoard/BrandAppearancePatentTab/task-delete-target 四件在飞改动 原样留在工作树未提交。 --- admin-frontend-vue/src/App.vue | 5 + admin-frontend-vue/src/main.ts | 22 ++ .../src/pages/account/UsersPage.vue | 10 +- .../src/pages/records/DeviceLogsPage.vue | 9 +- .../src/pages/records/workbench-client-api.ts | 169 ++++++++- .../src/shared/api/error-report.ts | 141 ++++++++ .../pending-phase4-包体与列表竞态.test.ts | 6 +- ...ending-phase4-错误兜底与大文件上传.test.ts | 29 +- admin-frontend-vue/vite.config.ts | 4 +- .../ClientErrorReportController.java | 60 +++ .../file/controller/FileUploadController.java | 94 +++++ .../file/service/ChunkedUploadService.java | 342 ++++++++++++++++++ .../file/service/LocalFileStorageService.java | 29 ++ .../file/service/oss/OssStorageService.java | 11 + ...WorkbenchClientPackageAdminController.java | 57 +++ .../WorkbenchClientPackageService.java | 113 +++++- .../src/main/resources/application.yml | 10 + .../config/CatchSilenceRatchetTest.java | 41 ++- .../ClientErrorReportControllerTest.java | 85 +++++ .../service/ChunkedUploadServiceTest.java | 149 ++++++++ ...ssWorkbenchClientLiveVerificationTest.java | 83 +++++ .../WorkbenchClientPackageServiceTest.java | 4 +- .../components/DeliveryVideoWorkspace.vue | 34 +- frontend-vue/src/shared/api/http.ts | 34 +- frontend-vue/src/shared/api/upload.ts | 122 ++++++- frontend-vue/src/shared/auth/ensure-auth.ts | 15 +- frontend-vue/src/shared/auth/kick-handler.ts | 2 +- .../src/shared/composables/useTablePaging.ts | 70 +++- .../tests/catch-silence-ratchet.test.ts | 7 +- .../mount/server-table-paging.mount.test.ts | 95 +++++ .../tests/pending-phase4-用户端稳定性.test.ts | 10 +- 31 files changed, 1798 insertions(+), 64 deletions(-) create mode 100644 admin-frontend-vue/src/shared/api/error-report.ts create mode 100644 backend-java/src/main/java/com/nanri/aiimage/modules/clienterror/controller/ClientErrorReportController.java create mode 100644 backend-java/src/main/java/com/nanri/aiimage/modules/file/service/ChunkedUploadService.java create mode 100644 backend-java/src/test/java/com/nanri/aiimage/modules/clienterror/controller/ClientErrorReportControllerTest.java create mode 100644 backend-java/src/test/java/com/nanri/aiimage/modules/file/service/ChunkedUploadServiceTest.java create mode 100644 backend-java/src/test/java/com/nanri/aiimage/modules/file/service/oss/OssWorkbenchClientLiveVerificationTest.java create mode 100644 frontend-vue/tests/mount/server-table-paging.mount.test.ts diff --git a/admin-frontend-vue/src/App.vue b/admin-frontend-vue/src/App.vue index 61bc9193d..b4aa2f6e2 100644 --- a/admin-frontend-vue/src/App.vue +++ b/admin-frontend-vue/src/App.vue @@ -1,6 +1,11 @@