Yii 2 生产环境资源缓存失效靠内容哈希实现，官方推荐使用 yii asset 命令生成带哈希文件名（如 app.a1b2c3d4.css）并自动更新引用，配合 forceCopy、linkAssets 配置及禁用调试模式确保哈希一致性。
Yii 2 的 AssetBundle 在生产环境启用合并压缩后，关键问题不是“能不能加版本号”，而是**如何让浏览器在资源内容变更时自动失效旧缓存**。这靠的是 Cache Busting（缓存粉碎）机制，核心是让资源 URL 随内容变化而变化——最常用、最可靠的方式就是附加内容哈希值作为查询参数或文件名后缀，而非简单用时间戳或手动改数字。
启用 asset 命令自动添加内容哈希
Yii 2 自带 yii asset 控制台命令，它不仅能合并压缩 CSS/JS，还能自动生成带哈希的文件名（如 app.a1b2c3d4.css），并更新 AssetBundle 中的引用路径。这是官方推荐的生产级方案。
- 先在配置文件（如
config/assets.php）中定义压缩规则，指定哪些 AssetBundle 参与合并、输出目录、是否启用哈希等 - 运行
yii asset config/assets.php assets.php，命令会读取源文件内容，计算 MD5 或 CRC32 哈希，生成带哈希的新文件，并输出一份新的assets.php配置供应用加载 - 此时 AssetBundle 的
$css和$js属性实际指向的是哈希化后的文件，URL 天然唯一且内容一致则 URL 不变，内容一变 URL 必变
AssetManager 的 forceCopy 和 linkAssets 配合使用
发布资源时，确保资源真正被复制或软链到 web 目录，避免因缓存或符号链接未更新导致旧文件残留。
-
'forceCopy' => YII_ENV_DEV ? true : false：开发环境强制复制，保证每次修改都能看到；生产环境设为false，依赖哈希文件名+首次发布即可 -
'linkAssets' => YII_ENV_PROD：生产环境启用符号链接（需 Web 服务器支持），加快发布速度，但前提是目标文件名已含哈希，否则链接可能指向旧目标
禁用调试模式，关闭资源自动转换干扰
YII_DEBUG = true 时，AssetManager 会跳过哈希计算，改用时间戳或不处理，还可能触发 LESS/SCSS 实时编译，破坏预构建的哈希一致性。
- 确认
web/index.php中没有define('YII_DEBUG', true) - 生产环境应显式设置
define('YII_ENV', 'prod')，让框架走优化路径 - 检查
AssetManager::appendTimestamp是否为false（默认就是 false），避免额外加时间戳干扰哈希 URL
CDN 场景下确保哈希 URL 被正确识别
若资源通过 CDN 分发，需确认 CDN 不会剥离查询参数（如果用了 ?v=xxx 方式），更推荐使用文件名哈希（main.abcd1234.js），因为 CDN 对静态文件名天然缓存友好且可精准失效。
- 在 AssetBundle 中不要硬编码带
?v=的 URL；让yii asset工具统一管理 - CDN 缓存策略建议设为“基于完整 URL”，这样哈希文件名变更即视为新资源，自动绕过旧缓存
- 上线新版本后，可通过 curl 检查 HTML 中引用的 JS/CSS URL 是否含新哈希，再验证该 URL 返回内容是否匹配最新构建结果
