根本原因是静态资源路径未变导致浏览器强缓存复用，需配置资源版本控制、nginx直供静态文件、模板使用url()/mix()函数生成路径，并启用immutable缓存。
ThinkPHP项目上线后用户反复刷新仍加载旧CSS和JS，页面样式错乱、功能异常，根本原因是静态资源路径未变导致浏览器强缓存复用，必须配置资源版本控制、Nginx直供静态文件、模板使用url()/mix()函数生成路径，并启用immutable缓存。
确认静态资源存放位置与Web服务器直供能力
第一步：打开终端，执行ls -la /path/to/your/project/public/，确认存在static/子目录，且其中包含css/、js/等标准结构。若资源放在app/或runtime/下，Nginx根本无法响应请求，直接返回404。
第二步：检查Nginx配置中location ^~ /static/是否位于所有~ \.php$规则之前。顺序颠倒会导致请求被PHP路由劫持，此时你加再多版本号也无效——因为请求压根没走到静态文件路径。
第三步：执行curl -I https://yoursite.com/static/css/app.css，观察响应头。若返回Content-Type: text/html或缺失Cache-Control，说明请求被框架路由捕获，【alias 必须指向 public/static 目录，且不能用 root 替代】。
模板中正确生成静态资源URL
硬写<link href="/static/css/app.css">是危险操作：一旦部署到子目录（如https://example.com/myapp/），路径立刻失效。ThinkPHP的url()辅助函数不只是为路由服务，它能动态拼接正确前缀。
方法一：在模板中统一使用{:url('static/css/app.css')}。该写法会自动适配app_host和url_domain_root配置，子目录部署也能正常解析。
方法二：对静态资源禁用URL后缀干扰，传第三个参数false：{:url('/static/css/app.css', '', false)}。否则当url_html_suffix设为.html时，会错误拼出/static/css/app.css.html。
方法三：在JS中动态加载资源时，别手拼/static/，改用框架注入的常量__ROOT__/static/。这个值由模板编译时生成，比硬编码更可靠，且不受运行时URL重写影响。
启用CDN域名并按环境动态切换
开发时用本地路径，生产走CDN，但不能靠硬编码切换——否则本地调试会因跨域或404卡死。
① 打开config/view.php，在'tpl_replace_string'数组中添加：'__STATIC__' => env('STATIC_DOMAIN', '/static')。
② 在.env中分环境写：
开发环境：STATIC_DOMAIN=/static
生产环境：STATIC_DOMAIN=https://cdn.example.com/static。
③ 模板中所有静态资源引用统一改为{__STATIC__/css/app.css}、{__STATIC__/js/main.js}。【必须弃用__ROOT__来加载静态资源，只用自定义替换符】。
这一步操作起来很简单，直接把文件拖进去就行。
配置Nginx启用immutable缓存与哈希防缓存
让浏览器知道“这个文件永远不会变”，从而长期缓存，直到URL本身改变。
在Nginx的location ^~ /static/块内添加：add_header Cache-Control "public, immutable, max-age=31536000";
同时启用资源哈希：在构建脚本中给文件名加md5，例如app.a1b2c3d4.css；模板里用{:url('static/css/app.css')}会自动映射到带哈希的路径——前提是开启config/app.php中的'url_build_mode' => 'rewrite'并配合mix()函数。
不这样做，每次更新CSS都得让用户清缓存，或者手动改HTML里的文件名。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
