500错误需查Apache错误日志而非访问日志，重点搜索PHP Fatal/Parse error等关键词；若日志无PHP报错，则排查Apache配置、模块加载或PHP-FPM模式兼容性问题。
看 Apache 错误日志里 PHP Fatal error 那一行
500 错误本身是 HTTP 状态码，不说明具体问题；真正线索在 Apache 的错误日志里，不是访问日志。默认路径通常是 /var/log/apache2/error.log（Debian/Ubuntu）或 /var/log/httpd/error_log（CentOS/RHEL）。直接搜 PHP Fatal error、PHP Parse error 或 PHP Warning，90% 的真实错误就藏在这几行里。
常见现象：页面空白或只显示“Internal Server Error”，但日志里有类似这样的内容：[Mon Jun 10 14:22:33.123456 2024] [php7:error] [pid 12345] [client 192.168.1.100:54321] PHP Fatal error: Uncaught Error: Call to undefined function mysql_connect() in /var/www/html/test.php:5
- 注意时间戳和
pid，可结合访问时间交叉验证 - 错误行号（如
:5）比浏览器报的更可信，尤其开启 opcache 后 - 如果日志空或没更新，检查
ErrorLog指令是否被覆盖，或 Apache 是否以不同用户运行导致无写权限
确认 PHP 是否真在运行，还是被 Apache 直接拒掉
Apache 返回 500 不一定代表 PHP 脚本执行出错——有可能根本没走到 PHP 解释器那步。比如 mod_php 模块没加载、AddHandler 配置错、或者 .htaccess 里写了非法指令。
快速验证方法：
在网站根目录放一个最简 info.php，内容只有 <?php phpinfo(); ?>，然后用 curl -I http://yoursite/info.php 看响应头。如果返回 500，且错误日志里没有 PHP 相关报错，大概率是 Apache 配置层的问题。
立即学习“PHP免费学习笔记（深入）”；
- 检查
a2enmod php7.4（或对应版本）是否执行过，再systemctl restart apache2 - 确认
httpd.conf或虚拟主机配置里有类似AddType application/x-httpd-php .php -
.htaccess中若含php_flag或php_value，而 PHP 是 FPM 模式运行，这些指令会被忽略甚至触发 500
临时打开 PHP 错误显示，但仅限开发环境
生产环境禁用 display_errors 是对的，但排查时可以临时启用，让错误直接打到浏览器——前提是 Apache 允许覆盖。
在出问题的 PHP 文件顶部加：
<?php
error_reporting(E_ALL);
ini_set('display_errors', '1');
ini_set('display_startup_errors', '1');
// 后续代码...
?>
如果仍看不到错误，说明 PHP 还没执行到这行——可能是语法错误（如漏了分号、括号不匹配）导致解析失败，或 php_admin_flag display_errors off 在 Apache 配置里强制关闭，此时无法用 ini_set 覆盖。
- 语法错误只能靠日志或命令行验证：
php -l /path/to/file.php - 若用 PHP-FPM，还要检查
www.conf里的php_flag[display_errors] = on是否生效 - 注意：改完别忘了关掉，否则可能泄露路径、数据库配置等敏感信息
检查 PHP 扩展依赖和权限问题
很多 500 错误实际是扩展缺失或文件不可读，比如 Laravel 报 Class 'PDO' not found，其实是 pdo_mysql 没装；或者 WordPress 插件尝试写 wp-content/cache 但 Apache 用户（如 www-data）没写权限。
查扩展是否加载：php -m | grep pdo；查当前 PHP 配置位置：php --ini；查 Web 请求实际用的 PHP 配置（和 CLI 可能不同）：phpinfo() 页面里的 “Loaded Configuration File”。
- 扩展未启用时，错误日志通常写
PHP Fatal error: Uncaught Error: Class 'XXX' not found，但不会说“因为扩展没开” - 权限问题常伴随
Warning: require(): failed to open stream或failed to open dir，注意看提示的路径属主是否为www-data或apache - SELinux 启用时（如 CentOS），即使权限 755 也可能被拦，用
ausearch -m avc -ts recent查拦截记录
真正卡住的往往不是语法或逻辑，而是 PHP 模块状态、Apache 模块加载顺序、或某个被忽略的 php_admin_value 配置项。日志第一行没报错？那就看 Apache 启动时有没有模块加载失败，再确认你调试的到底是哪个 PHP 实例。
