Fatal error无法被try/catch捕获，因其发生在Zend引擎底层崩溃点，脚本直接终止；需通过display_errors、error_reporting及register_shutdown_function暴露并记录错误。
PHP 的 Fatal error 不是“能 catch 住就能解决”的问题，它直接终止脚本执行，try/catch 完全无效——这不是写法错，是 Zend 引擎层面的硬性限制。
为什么 try/catch 捕获不到 Fatal error
因为 Fatal error（如 Call to undefined function、Class not found、syntax error）发生在 PHP 解析或执行阶段的底层崩溃点，引擎没机会把控制权交还给用户代码。哪怕你写了 try { require 'missing.php'; } catch (Throwable $e) { }，脚本也会在 require 行直接退出，catch 块根本不会执行。
常见误判现象包括：
- 浏览器白屏或返回空响应，但日志里查不到错误记录
- CLI 下运行
php script.php显示错误，但 Web 环境下完全静默 -
set_error_handler()对Fatal error完全无反应
怎么第一时间看到 Fatal error 的原始信息
关键不是“捕获”，而是“让它露出来”。开发环境必须主动暴露错误，而不是等它静默失败：
立即学习“PHP免费学习笔记（深入）”；
- 在脚本开头加三行：
ini_set('display_errors', 1); ini_set('display_startup_errors', 1); error_reporting(E_ALL); - 确认 php.ini 中
display_errors = On、error_reporting = E_ALL、log_errors = On，且error_log指向一个 Web 服务器用户有写权限的绝对路径（如/var/log/php/error.log） - 改完配置后必须重启服务：Apache 用
sudo systemctl restart apache2，PHP-FPM 用sudo systemctl restart php*-fpm（版本号需匹配） - CLI 模式下直接运行
php script.php，错误会原样输出到终端——这是最干净、最可靠的报错来源
如何在脚本终止前做最后兜底记录
唯一能稳定介入 Fatal error 发生后的时机，是 register_shutdown_function()。但它只在脚本“即将结束”时触发，不能恢复执行，只能做轻量日志或告警：
- 必须放在入口文件最顶部（比如
index.php第一行），否则中间require出现 fatal 就来不及注册 - 只调用
error_get_last()判断是否真发生了致命错误：in_array($error['type'], [E_ERROR, E_PARSE, E_COMPILE_ERROR]) - 禁止在 shutdown 函数里连数据库、发 HTTP 请求或调用复杂对象方法——资源可能已释放，容易引发二次崩溃
- 示例代码：
register_shutdown_function(function() {
if ($error = error_get_last()) {
if (in_array($error['type'], [E_ERROR, E_PARSE, E_COMPILE_ERROR])) {
error_log("FATAL: {$error['message']} in {$error['file']}:{$error['line']}");
}
}
});
排查 Fatal error 最常忽略的三个点
很多问题卡在看似无关的环节：
-
require或include路径错误时，报的是Fatal error: Failed opening required，但实际原因可能是相对路径计算错、open_basedir限制或 SELinux 权限拦截 - PHP 版本升级后出现新 fatal（如 PHP 8.0+ 的
TypeError在严格模式下直接终止），而旧代码没做类型兼容处理 - 错误日志路径被写死为
/tmp/php-error.log，但容器或云环境里/tmp不可写，导致日志“看起来没记录”
真正有效的排查，永远从错误信息里的文件名和行号开始，而不是先猜逻辑。如果连这行都看不到，说明错误显示和日志配置还没到位——这点比任何调试技巧都优先。
