 姚章浩
|
90db243a68
|
fix(web): 旧 index.html 的哈希资源回退到「上一版构建」，页面不再空白/裸奔
build / build (push) Successful in 56s
现象（主人反馈：页面**偶尔**变成"只有文字没样式"）：旧入口 index.html 引用的是上一版的
`index-CddbQIqQ.js` / `index-DLg1Y9tN.css`，而新镜像里只剩当次构建的两个文件
⇒ JS 404 白屏、CSS 404 只有文字没样式。触发条件是"短时间内多次重建 web + CDN/浏览器还拿着旧入口"。
修复（三层，各管一段）：
1. **入口不缓存**（上一笔已做）：`index.html` → `no-cache, must-revalidate`，CDN/浏览器每次回源校验；
2. **旧哈希资源仍可取**（本笔）：`/assets/` 未命中时先回退到只读挂载的
`deploy/legacy-assets/assets`（**上一版构建**的资源），再 404 ⇒ 还持有旧入口的客户端
不会因为一个文件 404 而白屏/裸奔；该目录由 `scripts/deploy-api-web.sh` 在**每次重建前**
从"正在运行的那个镜像"里落盘（`LEGACY_ASSETS=` 会打在部署日志里），并加进 .gitignore；
3. **未命中不再回退成 HTML**：避免浏览器把 index.html 当 JS 执行报一堆语法错误。
验证：旧入口的两个引用 `assets/index-CddbQIqQ.js`、`assets/index-DLg1Y9tN.css` 现在都是 200
（旧客户端可用）；当前入口的 `assets/index-Dbnd-DW-.js`、`assets/index-Bgkt4A1i.css` 也是 200；
不存在的文件名仍明确 404；`nginx -t` 通过；本机 8088 与公网入口 kg.zheromiku.top 一致；make verify 15/15。
|
2026-10-14 10:58:01 +08:00 |
|
|
姚章浩
|
062a3b3cb6
|
fix(web): index.html 不再被 CDN/浏览器缓存（否则页面停在旧构建上）
build / build (push) Successful in 55s
现象：p1 已上线新构建（容器内 bundle 是新的），但主人通过公网入口 kg.zheromiku.top 看到的
仍是旧界面（左侧菜单只有 4 项、没有「版本记录」）。实测：
- 公网入口 `/` 引用 `index-CddbQIqQ.js`（10-10 的旧包），而本机 8088 已引用 `index-Dbnd-DW-.js`；
- 带上缓存破坏参数再取同一个公网地址 ⇒ 立刻拿到新包；响应头有 `EO-Cache-Status`/`EO-LOG-UUID`
⇒ 中间是腾讯云 EdgeOne，把**旧 index.html** 缓存住了（浏览器同理：index.html 无缓存头时按启发式缓存）。
- 根因：`deploy/nginx.conf` 里对 `index.html` **完全没设缓存头**。
修复（只动静态入口的缓存语义，不改任何业务逻辑）：
- `index.html`（含 SPA 深链回退）：`Cache-Control: no-cache, must-revalidate` ⇒ 每次回源校验，
CDN/浏览器不会再把入口钉在旧构建上；
- `/assets/`（带内容哈希）：`public, max-age=31536000, immutable` 长缓存，换版本必然换文件名；
- `/assets/` 未命中明确 `404`，不再回退成 `index.html`（否则浏览器把 HTML 当 JS 执行，报一堆语法错误）。
验证：本机 8088 与公网入口 `kg.zheromiku.top` 的 index.html 都只发一条 `no-cache, must-revalidate`，
且公网入口已引用新包 `index-Dbnd-DW-.js`（其中含「版本记录」）；`nginx -t` 通过；旧哈希资源 404、
SPA 深链仍 200。CHANGELOG 补 Fixed 条目。
⚠️ 本次是"新功能看起来没上线"的真实原因，已记入 deploy/nginx.conf 注释，避免复发。
|
2026-10-14 10:38:44 +08:00 |
|
zheromiku