PHP 网站打开一片空白,或者干脆甩出一句"500 Internal Server Error",是最让人抓狂的体验之一:它不像 404 能告诉你"文件没找到",也不像 502 能提示"后端连不上",500 就是一个笼统的"服务器内部错误",什么线索都不给。更糟的是,很多生产环境为了避免泄露路径和代码信息,把 PHP 的错误显示关掉了,于是页面上只剩一个 500,真正的报错藏在日志里。
这篇文章就是教你"顺着日志把 500 揪出来"。会讲清楚 PHP 的报错到底会写到哪些地方(PHP 错误日志、PHP-FPM 日志、Nginx/Apache 错误日志、应用框架日志),怎么区分"语法错误""权限问题""超时""内存耗尽"这几类常见 500,以及如何在不暴露敏感信息的前提下临时打开错误显示来定位问题。文中涉及的路径、参数都是主流发行版默认或常见配置,具体以你的系统为准。
读完之后,你应该能做到:看到 500 先不慌,按固定顺序翻几处日志,基本能在一两轮内定位到文件、行号和原因,而不是靠猜和重启。
一、500 到底是什么,谁返回的
500 是 HTTP 的通用服务端错误码。对 PHP 站点来说,它可能由几个不同的角色产生:
- Web 服务器(Nginx/Apache):当后端 PHP-FPM 返回了无效响应,或 PHP 脚本执行失败时,由 Web 服务器返回 500。
- PHP-FPM:当子进程崩溃、脚本致命错误(fatal error)时,可能直接返回 500。
- 应用框架(Laravel、ThinkPHP 等):框架捕获到未处理异常后,也可能主动返回 500 并渲染错误页。
所以排查 500,第一步是确认这个 500 是哪一层发的。方法很简单:看响应头、看各层日志的时间点。多数情况下,PHP 的致命错误会在 PHP 错误日志里留下一条记录,这就是最直接的入口。
有个很实用的判断技巧:如果所有 PHP 页面都 500,往往是环境级问题(FPM 挂了、socket 权限错、扩展缺失),跟具体代码无关;如果只有某一个页面 500,而其他页面正常,那基本就是那个脚本自己的问题(语法错误、逻辑异常、依赖缺失)。先做这个二分,能省掉大量盲目翻找。另外一个常见现象是"改了代码立刻 500",这十有八九是刚改动引入的语法错误或调用了不存在的方法,用 php -l 逐文件查一遍通常立刻现形。把这些经验记住,排查时心里先有个方向,比一条条日志乱翻高效得多。
二、PHP 的报错会写到哪几个地方
这是全篇最关键的一节,把"日志在哪"搞清楚,500 就解决了一半。
| 日志来源 | 典型路径(RHEL 系) | 典型路径(Debian 系) | 记录内容 |
|---|---|---|---|
| PHP 错误日志 | /var/log/php-fpm/www-error.log 或 php.ini 指定 |
/var/log/php7.4-fpm.log 等 |
PHP 致命错误、警告 |
| PHP-FPM 主日志 | /var/log/php-fpm/error.log |
/var/log/php7.4-fpm.log |
FPM 进程启停、池错误 |
| Nginx 错误日志 | /var/log/nginx/error.log |
/var/log/nginx/error.log |
上游(php-fpm)通信错误 |
| Apache 错误日志 | /var/log/httpd/error_log |
/var/log/apache2/error.log |
脚本错误、权限问题 |
| 应用框架日志 | /var/www/xxx/storage/logs/ |
同左 | 业务异常堆栈 |
有两条命令几乎是排查 PHP 问题的"起手式":
# 1. 看 PHP 错误日志尾部(路径按实际调整)
sudo tail -n 100 /var/log/php-fpm/www-error.log
# 2. 看 Web 服务器错误日志尾部
sudo tail -n 100 /var/log/nginx/error.log
# 或 sudo tail -n 100 /var/log/httpd/error_log
如果日志里出现类似 PHP Fatal error: Uncaught Error: ... in /var/www/html/index.php on line 42,恭喜,你已经拿到文件、行号和原因了。
三、最常见的几类 500 原因
1. 语法/致命错误
改完代码后立刻 500,多半是语法错误或调用不存在的方法。用 PHP 自带的语法检查:
# 检查某个文件语法
php -l /var/www/html/index.php
# 输出 "No syntax errors detected" 才正常
2. 文件权限问题
PHP-FPM 以特定用户运行(RHEL 系常为 apache,Debian 系常为 www-data),如果代码目录或日志目录属主不对,写日志失败可能连锁导致 500。
# 看站点目录属主
ls -ld /var/www/html
# 修正属主(按发行版选用户)
sudo chown -R apache:apache /var/www/html # RHEL/CentOS/Rocky
sudo chown -R www-data:www-data /var/www/html # Debian/Ubuntu
# 目录 755、文件 644
sudo find /var/www/html -type d -exec chmod 755 {} \;
sudo find /var/www/html -type f -exec chmod 644 {} \;
风险提示:不要用 chmod -R 777 图省事,那会让任何本地用户都能改写你的代码,是常见入侵入口。
3. 内存耗尽(Allowed memory size exhausted)
典型的日志文案是 Allowed memory size of 134217728 bytes exhausted(128M 是 php.ini 的常见默认值)。处理方向:先查是不是代码里有死循环、大数组、大文件读入,优先优化代码;确需提高,再调 memory_limit:
; php.ini
memory_limit = 256M ; 从 128M 提到 256M(经验值,按业务定)
4. 执行超时
Maximum execution time of 30 seconds exceeded 说明脚本跑太久。先找慢的原因(慢 SQL、外部接口慢),必要时调:
max_execution_time = 60 ; 秒,CLI 下另受 max_input_time 影响
同步还要看 PHP-FPM 的 request_terminate_timeout(见下节),三者配合才不会互相打架。
5. 扩展缺失或版本不匹配
升级 PHP 版本后常见 Call to undefined function mysqli_connect(),说明对应扩展没装。装扩展:
# RHEL / CentOS / Rocky
sudo dnf install -y php-mysqlnd php-gd php-mbstring php-xml
sudo systemctl restart php-fpm
# Debian / Ubuntu(版本号按实际,如 php8.1-mysql)
sudo apt install -y php-mysql php-gd php-mbstring php-xml
sudo systemctl restart php8.1-fpm
四、PHP-FPM 池配置里的坑
很多 500 其实不是 PHP 代码问题,而是 PHP-FPM 进程池管理不当。核心参数:
; /etc/php-fpm.d/www.conf (RHEL 系)
; /etc/php/8.1/fpm/pool.d/www.conf (Debian 系)
pm = dynamic ; 进程管理方式:static/dynamic/ondemand
pm.max_children = 50 ; 最大子进程数,决定并发上限(经验值)
pm.start_servers = 5
pm.min_spare_servers = 5
pm.max_spare_servers = 35
pm.max_requests = 500 ; 每个子进程处理多少请求后重启,防内存泄漏
request_terminate_timeout = 60s ; 单请求最长执行时间,超时被 kill
几个关键点:
pm.max_children太小:并发一上来,FPM 没有空闲子进程处理请求,Nginx 会收到 502/504,用户看到 500。按内存估算:假设每个 PHP 进程占约 50MB(经验值),机器有 2GB 可用给 PHP,max_children大约 40 左右,别把机器内存榨干。request_terminate_timeout:比 PHP 的max_execution_time稍大即可,若设太小,慢请求会被 FPM 强杀,表现为偶发 500。pm.max_requests:设置为几百可以让子进程定期重启,规避第三方扩展的内存泄漏,代价是极小的性能抖动。
改完 PHP-FPM 配置要重启(FPM 通常不支持 reload 应用池配置的部分变更,稳妥起见用 restart):
sudo php-fpm -t # 配置语法检查
sudo systemctl restart php-fpm # RHEL 系
sudo systemctl restart php8.1-fpm # Debian 系示例
风险提示:restart 会短暂中断服务,建议低峰期操作;改配置前先备份 www.conf,出问题立即还原重启。
五、临时打开错误显示来定位(谨慎用)
生产环境为了安全,display_errors 通常是 Off。排查时可以临时打开,但必须限定范围、用完立刻关掉,否则会把文件路径、SQL、甚至敏感数据暴露给访问者。
; php.ini(不要长期在生产开启!)
display_errors = On
display_startup_errors = On
error_reporting = E_ALL
更稳妥的做法是只开日志、不开显示,让错误进日志:
log_errors = On
error_log = /var/log/php-fpm/www-error.log
display_errors = Off
# 改完记得让 FPM 重新加载/重启生效
sudo systemctl restart php-fpm
六、一套完整的 500 排查流程
把上面内容串成可执行步骤:
# 第 1 步:确认 500 来自哪一层(看响应头和各层日志时间)
curl -I https://www.example.com/problem-page
# 第 2 步:看 PHP 错误日志(最关键)
sudo tail -n 100 /var/log/php-fpm/www-error.log
# 第 3 步:看 Web 服务器错误日志
sudo tail -n 100 /var/log/nginx/error.log
# 第 4 步:若报语法错误,逐文件检查
php -l /var/www/html/index.php
# 第 5 步:若报权限,核对属主与权限
ls -ld /var/www/html /var/www/html/storage
# 第 6 步:应用层错误看框架日志
sudo tail -n 100 /var/www/html/storage/logs/laravel.log 2>/dev/null
经验上,90% 的 500 在第 2 步就能看到原因;看不到的话,说明错误被吞了,就要去检查 php.ini 的 log_errors 是否开启、PHP-FPM 日志权限是否可写,或者用 Nginx 的 error.log 反推。
如果翻遍日志仍然一无所获,还有两种可能值得排查。一是错误在更早的阶段就发生了,比如请求根本没到 PHP,就被 Nginx 的某个 rewrite 或 fastcgi 参数错误挡下,这类问题要去 Web 服务器错误日志里找,而不是 PHP 日志。二是框架自己吞掉了异常,有些框架把致命错误转成"友好错误页"并不写系统日志,只写自己的日志目录,这时要去应用的 logs/ 目录里找堆栈。养成"PHP 日志、Web 服务器日志、应用日志三处一起看"的习惯,能大幅缩短定位时间。另外,定位到原因后,修复要遵循一条原则:能改代码就别改环境。比如内存超限,优先治死循环和大数组,而不是简单地把 memory_limit 一调了之,否则等于把问题往后拖。
常见问题
Q1:页面 500 但 PHP 日志里什么都没有,怎么办?
先确认 log_errors = On 且 error_log 路径可写;再看是不是 Web 服务器自己报的(如 Nginx 的 fastcgi 配置错、.htaccess 语法错),翻 Web 服务器错误日志。
Q2:改了 php.ini 为什么不生效?
php.ini 的路径要对。用 php --ini 看 CLI 用的是哪个,用 phpinfo() 或建一个 页面看 FPM 实际加载的配置文件(Loaded Configuration File)。FPM 修改后必须重启。
Q3:升级 PHP 后大量 500,最常见原因?
扩展缺失或扩展版本不匹配。用 php -m 列出已加载模块,对照应用需要补装扩展;同时确认 php-fpm 池配置路径随版本变了。
Q4:500 只在高并发时出现?
多半是 pm.max_children 不够或内存耗尽。看 PHP-FPM 日志里有没有 "server reached pm.max_children" 之类的提示,必要时提高子进程数或升级机器内存。
Q5:怎么避免把错误信息暴露给用户?
生产环境保持 display_errors = Off,只开 log_errors;给用户一个友好的自定义 500 页面,真实错误只留在服务器日志里。
总结
- 500 是笼统错误,先确认是哪一层发的;PHP 致命错误一般会写进 PHP 错误日志,这是首要入口。
- 按"PHP 错误日志 → Web 服务器错误日志 → 应用框架日志 → 语法/权限核对"的顺序排查,多数问题一轮定位。
- 常见根因是语法错误、权限不对、内存耗尽、执行超时、扩展缺失;对应用
php -l、修属主权限、调memory_limit、查慢逻辑、补装扩展。 - PHP-FPM 的
pm.max_children、request_terminate_timeout、pm.max_requests要按内存和业务量设,改完需重启并做好备份。 - 生产环境坚持
display_errors = Off+log_errors = On,既能排到错,又不把敏感信息暴露给访问者。
企业QQ咨询




