微信X5内核强制缓存HTML且无视Cache-Control等响应头，唯一稳定解法是URL参数或哈希版本化；Nginx需在location块内组合设置Cache-Control、Expires、Pragma并禁用ETag，但仅辅助，不能替代URL变更。
微信内置浏览器（X5内核）会强制缓存 HTML，即使 Nginx 已配置 Cache-Control: no-cache, no-store 或 Expires: 0，它仍可能复用本地缓存——这不是 Nginx 配置失效，而是微信主动绕过响应头的「缓存劫持」行为。
为什么微信浏览器无视 Nginx 的 no-cache 设置
微信 X5 内核对 text/html 类型资源有独立缓存策略：只要 URL 相同，就优先返回内存/磁盘缓存，几乎不校验 ETag、Last-Modified 或 Cache-Control 响应头。尤其在单页应用（SPA）中，用户刷新页面常看到旧 HTML，导致 JS/CSS 版本错配。
- 该行为与 Chrome/Firefox 完全不同，不是 bug，是 X5 的设计取向
- 仅影响 HTML 主文档，静态资源（JS/CSS/图片）通常仍遵守 Nginx 缓存头
- 微信 8.0.30+ 对
Cache-Control: no-store支持略有改善，但不可依赖
nginx 配置必须加上的三要素
单靠 add_header 不够，需组合使用响应头 + 状态码 + 路径匹配，且顺序不能错：
-
add_header必须放在location /或具体 HTML 路径块内，不能只写在server块顶层（会被子 location 覆盖） - 必须同时设置
Expires和Cache-Control，X5 对二者都敏感 - 推荐返回
200状态码（非304），避免 X5 错误复用协商缓存
location / {
add_header Cache-Control "no-cache, no-store, must-revalidate, max-age=0";
add_header Pragma "no-cache";
add_header Expires "0";
# 确保不触发 conditional GET
etag off;
if_modified_since off;
}最有效的绕过方案：URL 参数或版本哈希
既然无法靠响应头说服 X5，就让它「认为」每次都是新请求：
立即学习“前端免费学习笔记（深入）”；
-
前端构建时，在 HTML 引用路径后加时间戳或哈希，例如：
- Nginx 反向代理层动态注入参数（适合无构建流程的场景）：
location / {
# 对所有 HTML 请求追加 ?t= 时间戳（慎用，影响 CDN 缓存）
if ($request_uri ~ ^(.*)\.html$) {
rewrite ^(.*)$ $1?t=$time_iso8601 break;
}
try_files $uri $uri/ =404;
}- 更稳妥的做法：在
中用 JS 动态加载主 JS，并拼接版本号，让 HTML 本身保持「静态」但执行逻辑可更新
验证是否真正生效的关键检查点
别只看响应头，要抓包确认 X5 实际发出的请求和收到的响应：
- 用 Android 微信「调试模式」开启「网页调试」，通过 Chrome DevTools 查看 Network → Headers → Request URL 是否带时间戳、Response Headers 是否含你设的
Cache-Control - 观察 Response 的
Age头：若为0且X-Cache显示MISS，说明 Nginx 没走缓存；但 X5 仍可能本地缓存，所以必须配合 URL 变更 - 清除微信「设置 → 通用 → 清理缓存」后测试，否则旧缓存可能残留数小时
微信浏览器的 HTML 缓存是「双层」的：Nginx 层可控，X5 层不可控。想彻底解决，就得让 URL 变——这是目前唯一稳定可靠的路径。
