ThinkPHP 的 STATIC 常量不支持 CDN，因其编译期固化、不读配置；应改用自定义 static_url() 函数结合 CDN 域名与 manifest 哈希版本号，并禁用 debug 模式以确保 Nginx 缓存头生效。
为什么 __STATIC__ 生成的 URL 没走 CDN？
ThinkPHP 默认用 __STATIC__ 助手常量拼路径，但它只是简单拼接 APP_PATH 和配置里的 static 目录，不识别 CDN 域名。你改了 app.php 里的 'static' => 'https://cdn.example.com/static'，但模板里 {:__STATIC__}/js/app.js 还是输出本地路径——因为 __STATIC__ 是编译期确定的常量，不会动态读取配置。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 删掉所有直接使用
__STATIC__的地方，改用url()或自定义助手函数 - 在
config/app.php中添加'cdn_domain' => 'https://cdn.example.com' - 写一个全局助手函数，比如
static_url()，内部拼接config('cdn_domain') . '/' . ltrim($path, '/') - 确保该函数在模板中可用（注册到
view_replace_str或通过assign()注入）
资源版本号没更新，浏览器一直缓存旧文件
加 ?v=1.0.1 是常见做法，但 ThinkPHP 默认不自动注入版本号。手动写容易漏、难维护，而且构建时如果没同步更新，线上就出问题。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 别用时间戳（
?v=<?php echo time() ?>），它让缓存彻底失效，CDN 回源压力大 - 用文件内容哈希值：构建时生成
version.json，如{"js/app.js": "a1b2c3d4"}，PHP 读取后拼成js/app.js?v=a1b2c3d4 - ThinkPHP 6+ 可配合
think-filesystem插件读取本地 manifest 文件，避免每次请求都 fopen - 注意模板中引用路径要和 manifest 键名严格一致（包括大小写、斜杠方向）
url() 路由生成静态资源链接会出错？
url() 是为路由设计的，不是给静态资源用的。如果你写了 url('static/js/app.js')，框架会尝试匹配路由规则，找不到就抛 RouteNotFoundException，或者返回空字符串。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 绝对不要用
url()生成静态资源路径，这是典型误用 - 静态资源必须走独立域名或子路径，和路由解耦；CDN 域名本身就不该进路由系统
- 如果非要统一入口，可定义一个伪路由如
GET /res/:file，但增加 Nginx/PHP 层转发，得不偿失 - 更稳妥的是：前端构建阶段把所有
__STATIC__/xxx替换为 CDN 地址 + 版本号，后端只管吐纯 HTML
Nginx 配置 CDN 回源时，Cache-Control 头被 PHP 覆盖
即使你在 Nginx 里写了 add_header Cache-Control "public, max-age=31536000"，PHP 输出的 header('Cache-Control: ...') 会把它干掉——尤其开启 debug 模式时，ThinkPHP 自动加了 no-cache。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 上线前确认
app_debug为false，否则所有静态资源都会带Cache-Control: no-cache, must-revalidate - Nginx 配置里用
expires max;替代add_header，它优先级更高且不被 PHP 覆盖 - 检查是否启用了
output_buffering，某些中间件可能在 flush 前偷偷改 header - 用
curl -I https://cdn.example.com/js/app.js实测响应头，别只信浏览器开发者工具
CDN 和版本号看似两件事，但真正卡住人的往往是它们的组合逻辑：路径怎么生成、哈希怎么读、缓存头谁说了算。这些环节只要有一处没对齐，就表现为“明明改了代码，页面还是旧的”。
