diff --git a/backend-java/docs/migration-inventory.md b/backend-java/docs/migration-inventory.md index 0e0900054..0eb889227 100644 --- a/backend-java/docs/migration-inventory.md +++ b/backend-java/docs/migration-inventory.md @@ -20,7 +20,7 @@ 本地曾存在 `V132__web_config_add_is_latest.sql`、`V133__hide_redundant_indexes_invisible.sql`,与另一分支已在生产落库的 V134/V135 冲突。因 Flyway 未开启 `out-of-order`,把任何迁移编到 132/133 会在启动期报 "resolved migration not applied";因此这两条改为 **V136/V137**,132/133 永久退役,不可回填。 -后续新增迁移从 **V138** 起取号。 +后续新增迁移从 **V139** 起取号。 ## 约束 diff --git a/docs/ops/prod-decisions-2026-09-28.md b/docs/ops/prod-decisions-2026-09-28.md index ce202db2d..7187e38f9 100644 --- a/docs/ops/prod-decisions-2026-09-28.md +++ b/docs/ops/prod-decisions-2026-09-28.md @@ -1543,3 +1543,77 @@ jar `162,619,842 B` / md5 `a31df4a21e2bb97bf16b6be0529981cd`。 新端点的守卫形状(两台 `127.0.0.1:18080` 直连自测):`PUT .../modules/proxy` 不带凭据回 `{"success":false,"message":"未登录","code":401}` + HTTP 200 —— 既是"已上线"的证据,也再次印证 §17.1 的读法。 + +## 十九、本批发版记录:客户端任务管理看板(`c6ee759d…`),23:57 B / 23:59 A;麦象接口与 admin-vue 同批 + +三处一起上:Java 双机(`crawler-plugin` master,8 笔 `6b14cebe..dfb75dd0`)、麦象任务 API +(`maixiang_run_task` main,`337ac51`)、admin-vue 前端。两个仓推后 `git rev-list --left-right --count` 均 `0 0`。 + +改了什么(按主题): + +- **权限与菜单(V138)**:`biz_file_task` / `brand_crawl_tasks` 各加 `device_id` + + `idx_file_task_device_created(device_id, created_at)`;菜单行挂在 `admin_group_record` 父键下 + (route_path `task-center/board`,sort 84)。**迁移只插菜单行、不写 `user_column_permission`** —— + 默认管理员看不到,须超管在「用户管理 → 菜单权限」授权后才出现。 +- **后端看板 5 个只读接口**(`/api/admin/task-center/{overview,devices,tasks,tasks/detail,variant-tasks}`): + `userIds=null` 表示超管不过滤,非超管传可见用户集合;设备号只认 JWT 签名 claim,不接受任何客户端可控输入。 +- **13 个客户端任务创建入口**写 JWT `device_id`(历史行不回填,存量任务在设备视图里归不上设备属预期)。 +- **麦象侧** `/api/console/batch/tasks` 支持 uid 逗号多值(看板按可见账号过滤)+ items 返回 `res_mes`(失败原因上屏)。 +- **前端**:任务列表 / 设备 / 变体采集三个页签,筛选(业务/状态/设备/店铺/时间/账号名),汇总卡与详情抽屉。 + +验证: + +- 后端 `mvn -o test`:**3345 用例 / Failures 1 / Errors 0 / Skipped 7**。唯一红项 + `TxDurationBenchmarkTest.measurementRepeatableWithinTolerance`(1100 vs 3400,并发负载下的耗时抖动; + 单独复跑 8/8 绿,与本次改动无交集)。 +- admin-vue `npm test` **1636 通过 / 0 失败**;`npm run build` 成功。 +- 发版前三取证:无新增配置键;线上 jar 从 `a31df4a2` 起跳;Flyway = 137;`device_id` 列与菜单行均不存在 + (V138 幂等,可安全重跑)。 +- 麦象侧:三文件远端 md5 与本地一致 + 真实数据 E2E(多 uid=5、单 uid=2、伪 uid+真 uid=2,`res_mes` 有值)。 +- 打脚本前发现 `_deploy_maixiang_api.py` 的 `FILES` 漏 `main.py`(本次改动恰在 `main.py:528`)—— + 不补这行等于整个改动没发。已补为三文件。 + +部署与回读: + +| 项 | 主机B(23:57 先发) | 主机A(23:59 后发) | +| --- | --- | --- | +| Flyway | 137 → **138**(success=1) | 已是 138(复审) | +| health | 200 | 200 | +| 线上 jar md5 | `c6ee759dcf9a2fa8ca778977a78c922f` | 同 | + +- DB 落地核验:菜单行 `route_path=task-center/board / sort=84 / parent_id=101`;权限表相关行 = 0; + 两表 `device_id` 列 + 索引就位。 +- admin-vue:`admin-vue-20260929-000052`(57 文件),回滚点 `admin-vue-prev -> admin-vue-20260928-195218`; + 对外 `index-CotA1fCL.js` 与看板 chunk(18,932 B)命中新文案(疑似卡住 / 暂无符合条件的任务 / 变体采集 / 设备总数)。 +- 三个新接口未登录回 `{"success":false,"message":"未登录","code":401}` + HTTP 200(与既有接口同形状)。 +- 存量观察(非本次引入):A 重启后整点出现 `NoSuchFileException: /app/data/tmp/.xlsx` —— + 对时间戳与全日志归因为 `TempDirCapacityMonitor` 扫描撞上清理删除的竞态(09-20 起 87 次, + 上一版发版日的 00:00/01:00 同样出现)。 +- 麦象发布脚本两个假警报:`调度器启动: 0` 是 `tail -30` 被高频访问日志挤掉(实际 23:54:55 有启动行); + `看门狗无告警: 2` 是 `watchdog.log` 停在 09-17 的陈年日志(root crontab 已无条目)。两条校验应改成时间窗过滤。 + +## 二十、发版后 SQL 空跑抓到 collation 缺陷:设备花名册 3 条语句运行期必炸(热修 `ecb3be1d`,**待发布**) + +看板 mapper 全是注解 SQL + Java 常量拼接,语法与列名错误只有运行期才炸,启动期(Flyway/启动日志) +与不连库的单测都拦不住。于是把 `TaskCenterQueryMapper` 的 21 条 `@Select`(含 16 个常量、``/``) +渲染成可执行 SQL,按「超管最小」(所有 `` 关闭)与「全筛选打开」两视角共 42 条,在生产库只读空跑 +(会话级 `MAX_EXECUTION_TIME=5000` 兜底、`mysql --force` 遇错不停)。 + +结果:**设备花名册 3 条语句(`countRosterDevices`/`countOnlineDevices`/`listRosterDevices`,各 min/max +两形态共 6 处)全报 `ERROR 1271 Illegal mix of collations for operation 'UNION'`**,其余 18 条通过。 +根因:`device_log_file.device_id` 是 `utf8mb4_0900_ai_ci`,`biz_file_task`/`brand_crawl_tasks` 是 +`utf8mb4_general_ci`,三个 UNION 分支混排。对照实验(同库、同结构):修复前形态报 1271; +`d.device_id COLLATE utf8mb4_general_ci` 形态返回 2。 + +修法:日志侧显式 `COLLATE utf8mb4_general_ci` 归一(两票对一票、改动面最小),加回归测试 +`rosterDeviceIdUnifiesCollationBeforeUnion` 钉住;定向测试 22/0;修复后 42 条空跑 0 报错。 +修复后全量 `mvn -o test`:**3346 用例 / 0 失败 / 0 错误 / Skipped 7**(BUILD SUCCESS; +上一轮那个基准红项这次也过,坐实是负载抖动)。产物自查:jar `162,664,984 B` / +md5 `5bc38007b731a4c09028d6803c13e1bd`,`TaskCenterQueryMapper.class` 常量池含 `d.device_id COLLATE`, +`entries=2059` 且 `docs/` 条目 0。 + +影响面:权限未授权(`perm_rows=0`),没有任何管理员能打开看板 → 无用户可见影响; +但**授权前必须先把这个热修发上去**。状态:`ecb3be1d` 已推送 Gitea(`0 0` 回读)、 +热修 jar 已构建并自查;**待授权后两台发布**(A 发布前照旧做三取证)。 + +附带修正:`docs/migration-inventory.md` 取号提示 `V138 → V139`(V138 已被本批占用;索引 DROP 迁移尚未取号)。