symfony应用500错误需五步排查：一清缓存捕获终端报错；二验dom等核心php扩展；三查.env.local存在性及app_env/app_secret生效；四修var/cache与var/log权限，核对web服务器根目录指向；五建最小测试路由隔离控制器级问题。
当Symfony应用突然返回500错误页面，访问直接中断、日志沉默或只显示“Oops, an error occurred”，说明服务器已捕获异常但未透出具体原因——这正是生产环境最棘手的报错形态。
第一步：强制触发并捕获真实错误日志
进入项目根目录，执行：php bin/console cache:clear --env=prod --no-debug。这一步会清空缓存并强制重新编译容器，很多隐藏的配置加载失败、服务注册异常会在该过程中暴露在终端输出里。
如果命令卡住或报错，立即停住——此时终端显示的就是原始PHP致命错误，比如Class 'DomDocument' not found或Failed to load resource: class App\Kernel，这些信息比网页上的500更真实。
若命令成功，但网页仍500，立刻检查日志：tail -n 30 var/log/prod.log。注意：Symfony默认在prod环境下关闭错误显示，【prod.log必须存在且可写，否则所有错误静默丢失】。如果该文件为空或报Permission denied，说明日志路径权限错误，先修复权限再继续。
第二步：验证核心PHP扩展是否启用
运行php -m | grep -E "dom|xml|mbstring|json|ctype|filter"，确认DOM、XML、mbstring等Symfony强制依赖的扩展均已加载。缺任一模块都会导致启动崩溃，且不报明确提示。
Ubuntu/Debian系统下缺失DOM扩展时，执行：sudo apt install php-xml（PHP 8.x）或sudo apt install php7.4-xml（对应版本），安装后必须重启PHP-FPM：sudo systemctl restart php*-fpm。
macOS用Homebrew安装PHP时，DOM模块默认不启用，需编辑php.ini，取消;extension=dom前的分号，并确保extension_dir指向正确路径。
第三步：检查环境变量与配置完整性
方法一：确认.env.local文件存在且非空
进入config/目录，运行ls -la .env*。如果只有.env.local.example而没有.env.local，复制并编辑：cp .env.local.example .env.local。【.env.local必须存在且不可为空，否则Symfony启动时会因找不到APP_ENV或APP_SECRET而直接抛RuntimeException】
方法二：快速验证关键变量是否生效
执行php -r "echo getenv('APP_ENV').PHP_EOL;"，应输出prod；再执行php -r "echo $_ENV['APP_SECRET'] ?: 'MISSING';"，若返回MISSING，说明环境变量未加载，问题出在public/index.php中Dotenv::createUnsafeImmutable()调用失败或.env.local语法有误（如等号前后有空格、未加引号的特殊字符）。
第四步：定位Web服务器层面的权限与路径问题
第一步：确认Web服务器用户对var/cache和var/log有完全控制权
执行：sudo chown -R www-data:www-data var/cache var/log（Ubuntu/Debian）或sudo chown -R nginx:nginx var/cache var/log（CentOS/RHEL）。这一步不能跳过，否则缓存写入失败会导致500，且错误被吞掉。
第二步：验证Web根目录指向是否正确
Apache用户检查VirtualHost中DocumentRoot是否指向public/而非项目根目录；Nginx用户确认root指令是否为/var/www/myapp/public，且location ~ ^/index\.php(/|$)块内fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;已启用。
第三步：临时禁用重写规则排除干扰
将public/.htaccess重命名为.htaccess.bak（Apache）或注释掉Nginx配置中所有try_files和rewrite指令，然后直接访问https://yoursite.com/index.php。若此时能正常加载，说明重写规则与当前Symfony版本不兼容，需升级symfony/web-server-bundle或调整路由配置。
第五步：复现并隔离控制器级错误
步骤一：创建最小化测试路由
在src/Controller/TestController.php中新增：
#[Route('/test-500', name: 'test_500')]<br>public function test(): Response { return new Response('OK'); }
步骤二：清除缓存并访问/test-500
若该路径返回500，说明问题在框架初始化层（如Kernel、Bundle、事件监听器）；若返回OK，则问题锁定在原业务控制器或其依赖的服务中。
步骤三：逐个禁用自定义Bundle
打开config/bundles.php，注释掉除Symfony\Bundle\FrameworkBundle\FrameworkBundle::class外的所有条目，再试访问。若恢复正常，说明某个Bundle的build()或boot()方法引发崩溃，需单独排查该Bundle的依赖注入配置或构造函数逻辑。
