ThinkPHP伪静态规则与CDN缓存策略的配合指南【指南】

多语言站点的缓存问题，十有八九出在伪静态规则和 CDN 策略的配合上。一个管路由怎么生成，一个管资源怎么缓存，两者各说各话，一旦没对齐，用户切语言时看到的还是旧页面，排查起来还特别隐蔽。下面这几条，是实战中最容易出问题的环节，逐个拆解清楚。

伪静态规则写错，CDN缓存就全乱套

伪静态本身不产生缓存，但它生成的 URL 形式——比如 /news/123.html——会被 CDN 当成独立资源来缓存。问题在于，如果 URL 不带语言标识，CDN 根本分不清这是中文页还是英文页，用户一切语言，看到的还是旧版本。

核心原则很简单：伪静态路由必须和 CDN 的缓存键对齐。但实际中常见的坑不少：

• Apache 的 .htaccess 没加 QSA 标志，导致 ?lang=en 这类参数被直接丢弃
• Nginx 用了 if (!-e $request_filename) 而不是 try_files，结果静态资源被误转发，PATH_INFO 解析也跟着失败
• ThinkPHP 里 url_html_suffix 设成了 'html'，但 CDN 规则却对所有 *.html 统一缓存 1 天，完全没有考虑语言维度
• 项目部署在子目录（比如 /myapp/），.htaccess 里漏了 RewriteBase /myapp/，重写后路径错位，CDN 回源直接 404

CDN 缓存键必须包含 Accept-Language

多语言站点不能指望靠 URL 来区分缓存，得靠请求头。CDN 层必须启用 Accept-Language 作为缓存键的一部分，否则所有语言的请求都会打到同一个缓存副本上，结果可想而知。

不同厂商的叫法虽然不一样，但逻辑是同一回事：

• 阿里云：在「缓存配置」→「自定义缓存键」里勾选 Accept-Language
• 腾讯云：在「缓存规则」→「缓存参数」中添加 Accept-Language
• Cloudflare：用 Page Rules + Cache Level = Cache Everything，再配合 Cache Key Customization 启用 header-based key

需要注意一点：Accept-Language 的值是客户端发送的原始字符串（比如 zh-CN,zh;q=0.9,en;q=0.8），CDN 一般会自动归一化为主语言标签（zh-CN）。别指望它识别 lang=zh 这种 query 参数——那是给你后端解析用的，CDN 根本看不到。

asset() 生成的路径必须走 CDN，否则回源就 404

asset() 是唯一可信的静态资源路径生成方式。硬编码 /static/lang/zh-CN.json 或者用 __STATIC__ 拼接，都会让 CDN 无法匹配回源规则，结果就是 404 满天飞。

这里必须做到三件事：

• 配置 app.asset_url 为完整 HTTPS 地址，例如 'https://cdn.example.com'，不能只写域名
• CDN 回源路径设为 /public（阿里云要带尾斜杠，腾讯云建议不带），确保请求 https://cdn.example.com/static/lang/zh-CN.json 能正确映射到服务器上的 public/static/lang/zh-CN.json
• 语言 JSON 文件的响应头设为 Cache-Control: public, max-age=3600，别设成一年——否则改了翻译用户半天看不到更新

HTML_CACHE_ON 和伪静态后缀天生互斥

只要开了 HTML_CACHE_ON，ThinkPHP 就会把渲染结果写成 .shtml 文件，比如 /about.shtml。而伪静态规则又把 /about 映射到这个文件——CDN 一旦缓存了它，就再也分不清语言了。

解决方案很明确：

• 多语言项目里，HTML_CACHE_ON 必须设为 false，哪怕只在首页或文章页用了语言切换
• 如果真要缓存 HTML，只能退回到「动态缓存」：用 Cache::tag('lang_zh')->set() 按语言前缀存，模板里用 Cache::tag('lang_zh')->get() 取，绕过静态文件生成
• 伪静态后缀（url_html_suffix）和 query 参数（?lang=zh）二选一。后者更可控，CDN 规则里显式包含 lang 参数即可，不用依赖 header

最容易忽略的一点是：CDN 缓存策略和 ThinkPHP 的路由配置是两层独立逻辑，改了其中一层，另一层未必自动适配。上线前务必用 curl 加上 -H "Accept-Language: en-US" 和 -H "Accept-Language: zh-CN" 分别测一遍响应内容是否一致，这一步省不了。