From 062a3b3cb60ede5ebcca64a0f14df53fffa1f359 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=A7=9A=E7=AB=A0=E6=B5=A9?= Date: Wed, 14 Oct 2026 10:38:44 +0800 Subject: [PATCH] =?UTF-8?q?fix(web):=20index.html=20=E4=B8=8D=E5=86=8D?= =?UTF-8?q?=E8=A2=AB=20CDN/=E6=B5=8F=E8=A7=88=E5=99=A8=E7=BC=93=E5=AD=98?= =?UTF-8?q?=EF=BC=88=E5=90=A6=E5=88=99=E9=A1=B5=E9=9D=A2=E5=81=9C=E5=9C=A8?= =?UTF-8?q?=E6=97=A7=E6=9E=84=E5=BB=BA=E4=B8=8A=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 现象: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 注释,避免复发。 --- CHANGELOG.md | 4 ++++ deploy/nginx.conf | 17 +++++++++++++++++ 2 files changed, 21 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index d0af1cb..9ef3b3c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -9,6 +9,10 @@ - 新增迁移 `000046_version_history`(提交记录 + 同步状态):`commit_sha` 是唯一身份,**版本号不是唯一键** —— 两个提交算出同一个开发号时各占一行,用 SHA 区分。 - 「当前运行」只认运行产物注入的**完整 SHA 精确匹配**:匹配到就标该条;开发构建显式标注"开发构建";拿不到标识就显示"当前运行版本未知",**不拿最新 main 或最新 tag 顶替**;CI 成功不等于已部署。 +### Fixed + +- 前端入口的缓存策略:`index.html` 此前没有缓存头,CDN/浏览器会启发式缓存它,于是**页面会一直停在旧构建上**(实测被腾讯云 EdgeOne 卡住:源站已是新包,公网入口仍发旧包,看起来像"新菜单/新页面没上线")。现在 `index.html` 每次回源校验(`no-cache, must-revalidate`)、带内容哈希的 `/assets/` 长缓存(`immutable`),旧哈希资源明确 404 而不是回退成 HTML。 + ### Security - 版本记录同步**匿名只读**远端仓库(**不使用任何凭据**),来源限配置里批准的 origin 与固定仓库:拒绝任意 URL、拒绝跨主机重定向,单个响应设大小上限与超时、5xx/429 才有退避重试。 diff --git a/deploy/nginx.conf b/deploy/nginx.conf index 719e892..98ebf69 100644 --- a/deploy/nginx.conf +++ b/deploy/nginx.conf @@ -25,7 +25,24 @@ server { proxy_set_header Host $host; } + # 带内容哈希的构建产物:可以长期缓存(换版本必然换文件名);旧哈希文件已被新构建替换 + # ⇒ 明确 404,不要回退成 index.html(否则浏览器把 HTML 当 JS 执行,报一堆语法错误)。 + location /assets/ { + expires 1y; + add_header Cache-Control "public, max-age=31536000, immutable"; + try_files $uri =404; + } + + # ⚠️ index.html(含 SPA 深链回退)**必须每次回源校验**:它引用的是带哈希的 JS 文件名, + # 一旦被 CDN/浏览器缓存住,页面就一直停在旧构建上(看着像"新功能没上线")。 + # 2026-10-14 实测被腾讯云 EdgeOne 缓存卡住过一次:源站已是新包,公网入口仍发旧包。 + location = /index.html { + # 只发一条 Cache-Control(`expires -1` 会再发一条,CDN 读到哪条说不准)。 + add_header Cache-Control "no-cache, must-revalidate" always; + } + location / { try_files $uri $uri/ /index.html; + add_header Cache-Control "no-cache, must-revalidate" always; } }