Symfony5项目部署到主机prod模式出现500错误，dev模式运行正常

第一步：先获取具体报错信息 #

你看不到prod日志大概率是权限或配置问题，先做以下操作：

• 检查var/log目录权限，确保web服务运行用户（常见为www-data、apache）对该目录有读写权限，执行命令：

chown -R www-data:www-data var/
chmod -R 775 var/

• 临时开启prod调试模式：修改项目根目录.env.local文件，将APP_DEBUG=0改为APP_DEBUG=1，刷新报错路由即可看到完整错误栈，排查完成后务必改回APP_DEBUG=0，避免泄露敏感配置。

第二步：针对「清缓存正常、刷新后复现」的特征定位问题 #

该特征90%是缓存预编译逻辑和动态参数冲突导致，按优先级排查：

• 路由配置问题：prod模式下路由会预生成缓存，若你的路由配置（注解/YAML/XML）依赖会话、请求参数等动态值，第一次生成缓存时参数有效，第二次读取缓存时参数不匹配就会抛出500。执行命令php bin/console debug:router --env=prod，如果执行时就有报错，直接定位到对应的路由配置修复即可。
• 服务容器配置问题：如果你的自定义服务依赖请求实例、动态上下文参数，且没有标记为懒加载或者非共享，prod模式下容器预编译时会提前初始化服务，第一次请求生成缓存时参数正常，第二次请求复用容器时参数过期就会报错。检查config/services.yaml中对应服务的配置，按需增加lazy: true或shared: false配置。
• Twig模板问题：如果报错路由对应的Twig模板中直接调用了请求、会话对象的属性，未做判空兼容，prod模式下模板第一次编译正常，第二次渲染时上下文变化也会触发报错。你可以临时删除var/cache/prod/twig目录后刷新，若错误指向具体模板文件，直接修改模板做兼容处理即可。

第三步：调整生产环境缓存操作规范 #

不要通过web请求触发缓存生成，每次部署后统一用cli执行缓存命令，且执行命令的用户和web服务用户保持一致，避免缓存文件权限不兼容：

php bin/console cache:clear --env=prod --no-debug
php bin/console cache:warmup --env=prod --no-debug

内容的提问来源于stack exchange，提问作者Gedeon Chancel Makela