docs: 记 e344111a 两台发版验收,并纠正一条读法——200 不是守卫放行

A 重启代价:开机自回收本机遗留作业 count=3、7 分钟 20 条 scheduled worker claimed、
超限 0 条、ERROR 0;busy requeue 34 条含重启追赶,仍远低于 §十一 修前量级。

验收口径补一条:writeFailure 走 setStatus(SC_OK) + body code=401,401 又只打 debug,
所以"HTTP 200"和"[admin-guard] 0 条"都不能当"守卫没生效"的证据,要读 body 的 code。
This commit is contained in:
2026-09-28 19:14:56 +08:00
parent a022bfbe06
commit 37fb65cecd
+38
View File
@@ -1434,3 +1434,41 @@ JPEG 图片 entry 现在仍走 DEFLATE。JPEG 本身已压过,再 deflate 基
本轮为了拿到干净的发版门禁,采取的是第三条临时路:把本机 `backend-java/docs` 整目录 `cp -ru` 进 worktree
(不改仓库、不改测试),重跑这 7 个类得 **86 用例 0 fail 0 error**(19:02–19:03 的新 surefire 产物)。
---
## 十七、本批发版记录:`e344111a…`(守卫收窄 + xlsx 缓冲 + `.gitattributes`),19:09 B / 19:12 A
发版内容 = 提交 `29155e9e`(守卫)+ `d430ec54`(缓冲)+ `0fe2121b`(`.gitattributes`)+ 三条文档提交。
jar 出自隔离 worktree `tmp/head-build`,检出固定在 `0fe2121b`;`git diff --stat 0fe2121b..HEAD` 只多出
`docs/ops/prod-decisions-2026-09-28.md` 一个文件(jar 里 0 个 `docs/` 条目,已核),所以产物与 Gitea HEAD 同源。
**不含**另一路会话仍在改的 brand / usersecret / appearancepatent / 前端 18 个未提交文件。
产物自查(不只看 `BUILD SUCCESS`):`entries=2029`,`BOOT-INF/classes/.../AdminApiGuardFilter.class` 的
`shouldNotFilter` 里 `needsOwnershipBinding` 调用数 = **2**(改前 1);`WpsCellImageWriter.class` 与
`ExcelCellImageWriter.class` 各 2 处 `BufferedOutputStream` 引用 + 65536 缓冲区。
jar `162,617,089 B` / md5 `e344111aa7716f46e351c0de72ace433`(线上旧版 `6880abb0…` / 162,593,816 B)。
| 项 | 主机B(19:09 先发,发前空闲) | 主机A(19:12 后发,发前在飞) |
| --- | --- | --- |
| 替换后线上 md5 | `e344111a…` OK | `e344111a…` OK |
| health | 200 @ t+5s | 200 @ t+10s |
| Flyway | schema `aiimage` = 137,无需迁移 | 同 |
| instanceId | `server-121` continuityRisk=LOW | `server-110` LOW |
| 启动异常采样 | 无 | 无 |
| `开机自回收本机遗留作业` | 0 条 | **count=3** owner=server-110 cutoff=19:12:01 limit=20 |
| `scheduled worker claimed`(7 分钟窗) | 0 | 20 |
| `已达到最大重试次数` / `重发轮次已达上限` | 0 / 0 | **0 / 0** |
| `requeued because task lock is busy` | 0 | 34(≈4.9/min,含重启后追赶;§十一 修前是 33/min 量级) |
| ` ERROR ` | 0 | 0 |
| `[admin-guard]` | 0 | 0 |
| 启动生效配置两行 | `[task-resume] enabled=false`、`[client-task-pull] enabled=false` 均在 | 同 |
| `resume(ran=…)` 巡检 | `ran=false s=0 r=0 k=0 u=0`(开关仍未开,非故障) | 同 |
### 17.1 §14.5 的验收口径要补一句:`[admin-guard] 0 条` 不等于"守卫没生效"
`AdminApiGuardFilter.writeFailure` 是 `response.setStatus(SC_OK)` + body 里 `code=401/403`,
且 401 属 `isRoutineAuthNoise` 只打 debug。所以**光看 HTTP 状态码会把守卫的正常拒绝读成放行**:
本机 curl `http://127.0.0.1:18080/api/admin/users` 返回的是 `200`,body 是
`{"success":false,"message":"未登录","data":null,"code":401}` —— 这才是拒绝的形状。
读验收要读 body 的 `code`,或按 §14.5 去数 WARN 级 `[admin-guard] … 拒绝:登录身份 id=… 与请求参数 user_id=… 不一致`。