看PHP错误日志比刷浏览器快十倍,500错误本质是服务器端崩溃,应优先查看error_log文件;常见路径包括/var/log/apache2/error.log、/var/log/php-fpm.log等;需确保log_errors=On且error_log路径可写;display_errors仅限开发环境临时开启;.htaccess或Nginx配置错误、超时、内存耗尽、扩展缺失及SELinux等系统限制也可能导致无日志的500。

看 PHP 错误日志比刷浏览器快十倍
500 错误本质是服务器端崩了,但默认不把错误细节吐给浏览器。直接翻 error_log 文件是最有效起点——别猜,先看它报什么。
常见位置:/var/log/apache2/error.log(Apache)、/var/log/php-fpm.log(FPM 模式)、或项目根目录下的 php_errors.log(如果代码里设过 error_log 路径)。
- 用
tail -f /var/log/apache2/error.log实时监听,再刷新页面,错误立刻浮现 - 如果日志空,检查
php.ini中log_errors = On和error_log路径是否可写 - 线上环境通常禁用
display_errors = Off,靠日志是唯一可靠途径
临时开 display_errors 仅限开发机
想让错误直接打在页面上?可以,但只应在本地或测试环境做,且必须加条件限制。
- 在入口文件(如
index.php)最开头加:ini_set('display_errors', '1');
ini_set('error_reporting', E_ALL); - 切勿在
php.ini全局开启display_errors = On,否则可能泄露路径、变量、数据库结构 - 某些 500 是解析失败(比如语法错、PHP 版本不兼容),
display_errors也显示不了——这时只能靠日志或 CLI 执行:php -l your_script.php
检查 .htaccess 或 Nginx 配置引发的假 500
不是所有 500 都来自 PHP 代码。Web 服务器配置出错,也会返回 500 并拦截 PHP 执行。
立即学习“PHP免费学习笔记(深入)”;
- Apache 下检查
.htaccess是否有非法指令(如RewriteCond引用不存在的变量、php_flag在 CGI 模式下被禁用) - Nginx 常见坑:
fastcgi_pass指向错误的 socket 或端口,或fastcgi_param SCRIPT_FILENAME路径拼错,导致 PHP-FPM 收到空脚本 - 快速验证:临时重命名
.htaccess或注释掉 Nginx 的location ~ \.php$块,看是否还 500
超时、内存耗尽、扩展缺失也会报 500
这类错误往往不写进 PHP 日志,而是出现在 Web 服务器日志或系统层。
-
Fatal error: Allowed memory size of XXX bytes exhausted—— 查memory_limit设置,也可能是递归/死循环 -
PHP Fatal error: Maximum execution time of XX seconds exceeded—— 不是代码卡住,可能是 cURL、PDO 连接数据库超时未设timeout -
Call to undefined function curl_init()—— 对应扩展没启用,检查php -m | grep curl,确认extension=curl在php.ini里没被分号注释
真正难缠的是那些没留痕迹的 500:比如 SELinux 拦截了 PHP 写日志、systemd 限制了 PHP-FPM 进程数、或 opcache 编译缓存损坏。这时候得一层层剥,从 PHP CLI 执行开始,再套 Web 环境,不能跳步。











