ThinkPHP 8.0 静态资源缓存污染本质是浏览器复用旧文件，因URL未变且服务端未发送更新信号；需通过mix()或时间戳变更URL、Nginx直供静态文件并配置immutable响应头解决。
ThinkPHP 8.0 静态资源缓存污染，本质是浏览器复用旧文件导致新 CSS/JS 不生效，不是代码没更新，而是 URL 没变、服务端没发“该换新”的信号。
先确认是不是真被缓存污染了
- 打开浏览器开发者工具 → Network 标签页 → 刷新页面 → 找到某个 .css 或 .js 文件 → 看 Status 是 200（from memory cache 或 disk cache）还是 304 - 如果是 200（from cache），说明浏览器根本没发请求，直接用了本地副本 - 再用 curl 测试：`curl -I https://yoursite.com/static/js/app.js`，检查响应头是否有 `Cache-Control: public, immutable` 或 `max-age=31536000` 这类强缓存策略静态资源路径必须带可变标识
浏览器只认 URL。URL 不变，哪怕文件内容改了，它也认为“还是那个文件”，继续用缓存。解决的核心就一条：让每次构建后资源 URL 变掉。-
使用 Mix.version() 自动生成哈希文件名（推荐）
立即学习“PHP免费学习笔记（深入）”；
- 在
webpack.mix.js末尾加.version() - 运行
npm run production后，生成类似/static/js/app.js?id=abc123的路径 - Blade 中必须用
{{ mix('js/app.js') }}引入，不能硬写<script src="/static/js/app.js"> - ThinkPHP 无原生
mix()函数，需手动封装：在app/Helper.php中定义function mix($path)，读取public/mix-manifest.json返回真实路径
- 在
-
若不用构建工具，可用 PHP 动态加时间戳
- 在模板中写：
<link rel="stylesheet" href="/static/css/app.css?v={{ filemtime(public_path('static/css/app.css')) }}"> - 注意：
filemtime()要求文件真实存在且 Web 服务器有读权限，部署时若用 CI/CD 清过public/static/，可能报错
- 在模板中写：
确保 Nginx 正确直供静态文件
如果请求没走到 Nginx 静态服务层，而是被 PHP 路由捕获，那加再多版本号也没用。- 检查 Nginx 配置中
location ^~ /static/是否在所有\.php$规则之前 -
alias必须指向public/static目录，不能用root替代（否则路径拼接错误） - 用
curl -I验证响应头：应有Content-Type: text/css和Cache-Control字段；若返回text/html，说明请求被 PHP 处理了，配置需修正
避免缓存键冲突的细节
- 同一资源不要混用多种引入方式：比如有的地方用 `mix()`，有的地方手写 `?v=`，会导致两个 URL 同时存在，浏览器可能缓存两份，清理时漏掉一个 - 构建产物建议开启 `immutable` 响应头（Nginx 配置加 `add_header Cache-Control "public, immutable, max-age=31536000";`），告诉浏览器“这文件永不变”，后续请求直接走内存缓存，不发验证请求不复杂但容易忽略
