Symfony4+Webpack Encore生产环境CSS/JS资源加载失败排查

你已经做了大部分正确的部署步骤，不过大概率是踩了Symfony Asset组件的一个常见配置坑——生产环境下需要显式配置Manifest文件路径，这样Twig的asset()函数才会读取manifest.json里的映射关系，自动替换成带哈希的文件名。下面一步步排查解决：

1. 配置Asset组件的生产环境Manifest路径 #

Symfony 4默认不会自动启用manifest解析，你需要在生产环境配置文件里指定manifest的位置：

打开config/packages/prod/assets.yaml（如果没有就新建这个文件），添加以下配置：

framework:
    assets:
        json_manifest_path: '%kernel.project_dir%/public/build/manifest.json'

如果你的config/packages/assets.yaml已有基础配置，确保prod环境的配置覆盖了这个设置，或者直接在主配置中针对prod环境单独声明。

2. 彻底清理并预热生产环境缓存 #

虽然你执行了bin/console cache:clear --env=prod，但有时候缓存文件可能残留旧配置，建议手动删除缓存目录再重新预热：

rm -rf var/cache/prod
bin/console cache:warmup --env=prod

cache:warmup会提前生成生产环境的缓存，确保新的asset配置被正确加载，也能避免首次访问的延迟。

3. 验证Manifest文件的映射正确性 #

检查public/build/manifest.json里的条目是否正确，应该包含类似这样的映射：

{
  "build/css/global.css": "/build/css/global.9e04a9d9.css",
  "build/js/global.js": "/build/js/global.9e04a9d9.js"
}

如果映射的路径前缀错误，asset()函数也无法正确替换文件名。

4. 确认Twig Asset扩展正常工作 #

你的模板里{{ asset('build/css/global.css') }}的写法是正确的，但要确保Twig的asset扩展没有被禁用。检查config/packages/twig.yaml，默认情况下asset扩展是启用的，若之前修改过配置，确认没有相关禁用项。

额外排查点 #

• 如果你用Apache或Nginx部署，确保服务器根目录指向项目的public目录，而非项目根目录，否则asset路径会解析错误。
• 再次确认public/build下的哈希文件确实存在，且权限设置正确（你已经检查过归属www-data，这部分应该没问题）。

按上述步骤操作后，刷新页面应该就能看到asset()函数生成带哈希的资源路径了。

内容的提问来源于stack exchange，提问作者spacecodeur