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; } }