PHP网站出现500 Internal Server Error怎么办?错误日志与排查方法

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,既能排到错,又不把敏感信息暴露给访问者。