现象:页面白屏 500,日志一个字都没有
访问页面只看到 500 Internal Server Error,打开 Nginx 的 error.log 只有一行 upstream sent no valid HTTP/1.0 header 之类的记录,PHP 的错误日志是空的。换成另一个页面又正常,问题只出现在某个接口上。
原因:错误被三层同时吞掉了
- 生产环境的 php.ini 里
display_errors=Off,同时log_errors也没开,错误既不显示也不记录; error_log指向的目录不存在或不可写,PHP 写不进去也不会报错;- PHP-FPM 默认不把子进程的 stderr 输出到主日志,需要打开
catch_workers_output; - 框架捕获了异常,统一返回 500,原始堆栈只留在框架自己的日志里。
解决步骤
第一步,确认当前配置。CLI 和 FPM 读的 ini 可能不是同一份,以 FPM 的为准:
php -i | grep -E "display_errors|log_errors|error_log"
php --ini
第二步,临时打开错误输出。在站点目录放一个 .user.ini,不用改全局配置,排查完删掉即可:
display_errors = On
log_errors = On
error_log = /tmp/php_error.log
error_reporting = E_ALL
第三步,打开 FPM 的 stderr 捕获。修改 pool 配置后重启,段错误级别的崩溃也能看到:
catch_workers_output = yes
decorate_workers_output = no
第四步,用命令行复现。很多错误在 FPM 下被吃掉,在 CLI 里会完整打印。把入口文件按同样参数跑一次,堆栈立刻就出来了:
php -d display_errors=1 -d error_reporting=E_ALL index.php
第五步,看框架日志。Laravel 看 storage/logs/laravel.log,ThinkPHP 看 runtime/log,Z-BlogPHP 看 zb_users/logs。框架开了 debug 模式才会把异常写出来,生产环境通常刻意关掉。
排查完记得把 .user.ini 删掉或改回关闭状态,错误信息里带路径和 SQL,长期暴露在公网等于给攻击者递线索。同时确认 OPcache 没有缓存旧文件,改完 ini 要重启 FPM 才生效。
小结
500 且无日志,说明错误被显示开关、日志路径、FPM 输出三处同时挡住。先确认 ini 真实生效位置,再逐层打开,最后用 CLI 复现拿堆栈。
