Yii2.0.50接入CDN优化静态资源的核心是让CSS、JS、图片等由边缘节点就近分发，需协同调整AssetBundle配置、Web服务器缓存策略及CDN回源规则，避免404、样式错乱或缓存不更新。
Yii2.0.50 接入 CDN 优化静态资源，核心是让 CSS、JS、图片等不再走应用服务器，而是由边缘节点就近分发。这不单是改几个 URL 的事，得配合 AssetBundle、Web 服务器配置和缓存策略一起调整，否则容易出现 404、样式错乱或缓存不更新等问题。
修改 AssetBundle 配置，指向 CDN 域名
Yii2 用 AssetBundle 管理静态资源，不能直接在视图里硬写 https://cdn.example.com/css/app.css。应在自定义 AssetBundle 类中覆盖 $baseUrl：
- 在
assets/AppAsset.php中添加：public $baseUrl = '//cdn.example.com';（使用协议相对 URL，兼容 HTTP/HTTPS） - 确保该类已正确注册到
view组件的assetManager配置中 - 若需区分环境，可在
config/web.php中动态设置：'assetManager' => ['bundles' => ['app\assets\AppAsset' => ['baseUrl' => YII_ENV_PROD ? '//cdn.example.com' : '@web']]
保证资源路径与版本控制一致
CDN 缓存强依赖文件路径稳定性。一旦 JS 更新但 URL 不变，用户可能加载旧版缓存：
- 启用 AssetBundle 的
$hash版本号机制：在 AppAsset 中设public $appendTimestamp = true;，会自动在 URL 后加时间戳（如app.js?v=1734702600） - 更推荐使用文件内容哈希：配置
'assetManager' => ['appendTimestamp' => false, 'forceCopy' => YII_DEBUG]，再配合构建工具（如 Webpack）生成带哈希的文件名（app.a1b2c3.js），并用yii\redis\Cache或文件映射表管理路径别名 - 避免手动修改
public/assets/下的发布目录——CDN 域名下不应存在该路径，所有资源应提前上传至 CDN 源站（如 OSS 或静态服务器）
配置 Nginx 或 Apache，支持 CDN 回源与缓存头
CDN 节点需要从你的服务器回源拉取资源，同时你也要告诉 CDN 和浏览器“这个文件能缓多久”：
- 在 Nginx 的静态资源 location 块中加入：
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff2?|ttf|eot)$ {<br> expires 30d;<br> add_header Cache-Control "public, immutable";<br> add_header Vary Accept-Encoding;<br>} - 若使用阿里云/百度云 CDN，务必在控制台设置匹配的缓存规则（如
*.js缓存 7 天），且优先级高于源站 header - 禁止 CDN 缓存 HTML 页面：确保
Content-Type: text/html的响应带有Cache-Control: no-cache, no-store, must-revalidate，可通过Response::setHeaders()在控制器中统一设置
验证与灰度发布要点
上线前必须验证 CDN 是否真正生效，而不是只改了 URL 却仍回源：
- 打开浏览器开发者工具 → Network 标签页，刷新页面，检查 CSS/JS 请求的
Remote Address是否为 CDN 节点 IP，Response Headers中是否有X-Cache: HIT或类似字段 - 用
curl -I https://cdn.example.com/js/app.js查看返回的Cache-Control和Age值 - 首次上线建议灰度：先对部分子域名（如
staging.cdn.example.com）或 User-Agent 匹配内网请求开启 CDN，确认无资源 404、跨域或 CSP 报错后再全量 - 更新资源后，若 CDN 未及时刷新，调用厂商 API 手动预热或刷新（如阿里云
RefreshObjectCaches），不要依赖缓存自然过期
