生产环境最稳妥组合是JsonManifestVersionStrategy + UrlPackage，开发用StaticVersionStrategy('dev')；asset()是版本策略入口，必须经它生成URL，否则策略失效。
直接结论：用 JsonManifestVersionStrategy + UrlPackage 是生产环境最稳妥的组合，既解决哈希级精确缓存失效，又支持多CDN分发；开发阶段用 StaticVersionStrategy('dev') 足够，别硬套生产配置。
为什么不能直接写死 /build/app.js？
浏览器缓存会卡住旧文件，哪怕你改了内容、重传了文件，用户访问时仍可能加载带缓存的旧版本。Symfony 的 asset() 函数不是语法糖，它是整个版本策略的入口——所有静态资源 URL 必须经它生成，否则策略不生效。
常见错误现象：
- 改了
app.css，清了浏览器缓存也没用，因为 HTML 里还是href="/build/app.css" - 开了 CDN，但所有资源都走同一个域名，没实现负载均衡
- 本地开发能跑，部署后
404，原因是路径没映射到public/下真实位置
JsonManifestVersionStrategy 怎么配才不报错？
它依赖构建工具（Webpack/Vite）输出的 manifest.json 文件，必须确保该文件存在、格式合法、路径可读。Symfony 不会帮你生成这个文件，只负责解析。
实操要点：
-
manifest.json必须放在public/下可公开访问的路径，比如public/build/manifest.json - 在
config/packages/framework.yaml中启用它：framework: assets: json_manifest_path: '%kernel.project_dir%/public/build/manifest.json' - 确保 manifest 内容是扁平键值对，例如：
{"css/app.css": "/build/css/app.abc123.css"}，而不是嵌套结构 - 开启严格模式（可选）：加
strict_mode: true，开发时引用了 manifest 里不存在的资源会直接抛异常，避免上线后 404
CDN 域名怎么动态分发到不同资源？
用 UrlPackage 手动注册多个 CDN 域名，再配合自定义逻辑路由，比硬编码更可控。默认的 base_urls 配置只支持轮询，无法按资源类型区分。
实操建议：
- 不要只配一个
base_urls: ['https://cdn.example.com']，那样等于没用 CDN 优势 - 按文件扩展名分流更实用：
$cdnMap = [ 'js' => ['https://js-cdn.example.com', 'https://js2-cdn.example.com'], 'css' => ['https://css-cdn.example.com'], 'img' => ['https://img1-cdn.example.com', 'https://img2-cdn.example.com'], ]; - 继承
UrlPackage写个轻量类，在getUrl()里根据$path后缀选域名，再调用父类逻辑 - 注意：CDN 域名必须带协议（
https://），否则生成的 URL 会变成相对路径
开发和生产环境的配置差异容易被忽略
很多人把 json_manifest_path 直接写死在全局配置里，结果开发时因 manifest 不存在直接崩溃。正确做法是按环境拆分。
关键点：
- 开发环境用
StaticVersionStrategy('dev')，配置在config/packages/dev/framework.yaml：framework: assets: version: 'dev' - 生产环境禁用
version，只启用json_manifest_path，且确保 manifest 文件已由 CI/CD 步骤生成并同步到public/ -
base_path和base_urls也应按环境区分：本地用/，生产用 CDN 数组 - 别忘了检查
public/权限——如果 PHP 进程读不到manifest.json，asset()会静默回退到无版本路径，问题极难排查
