ThinkPHP无法捕获Parse/Compile error、Fatal error（如内存耗尽、类未找到）、PHP启动期扩展崩溃、exit()/die()及E_ERROR等错误，因其绕过set_error_handler；需用register_shutdown_function+error_get_last()补漏，并配置log_errors确保底层日志记录。
ThinkPHP 的异常捕获并不“全”——它默认只接管了
和
（PHP 7+）的顶层抛出，但大量实际运行中的错误类型（比如未定义变量、语法错误、致命错误早期阶段、扩展层崩溃）根本不会走到框架的异常处理流程里。
哪些错误 ThinkPHP 根本捕获不到
框架的
类只在
中通过
和
挂钩，但它对以下情况完全无能为力：
、
：PHP 解析或编译失败时，脚本根本没执行到框架初始化，
都没被调用
（如
、
在
之前）：部分 fatal error 不触发
，尤其在 autoloader 失败或内存超限时
PHP 启动阶段扩展崩溃（如 opcache segfault、xdebug 配置错误）：进程直接退出，无 PHP 层干预机会
/
调用：属于主动终止，不是异常，框架不拦截
覆盖不了的 PHP 错误级别
ThinkPHP 的错误
处理器
默认忽略
、
、
、
、
等——这些错误会绕过
直接中止脚本。你看到的“白屏”或“500”，往往就是这类错误。
即使你手动在
前加
，也改变不了这个限制。PHP 的设计如此，不是框架能绕过的。
立即学习
“
PHP免费学习笔记（深入）
”；
验证方式很简单：
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。
下载
自定义
补漏是唯一可行方案
要捕获
和部分解析错误的残留信息，必须靠
+
组合。ThinkPHP 默认不启用这个，需手动补上：
放在
框架加载前（即
之前）
注意避免重复注册（TP 6.1+ 的
已内置该逻辑，但仅限 CLI 场景；Web 场景仍需自行加固）
日志写入必须用同步方式（如
），不能依赖 TP 的日志驱动（此时容器可能未初始化）
配置
和
是底层兜底
别迷信框架异常处理器。生产环境必须关掉
（防止敏感路径泄露），但要确保
且
指向可写文件。这是 PHP 自身最可靠、最底层的错误记录通道，比任何框架逻辑都优先。
常见疏漏点：
Nginx + PHP-FPM 下，
的
可能被 FPM 的
覆盖，得查 FPM pool 配置
某些 Docker 镜像默认把
指向
，日志会进容器 stdout，而非文件
TP 的
只影响框架层渲染，不影响 PHP 是否记录 fatal error
真正关键的不是“TP 能捕获多少”，而是你有没有在 PHP 运行时、Web 服务器、容器/系统三个层面都留了可观测出口。框架只是中间一环，太依赖它，出问题时连错误在哪一层都定位不了。
ExceptionErrorthink\exception\Handleregister()set_exception_handlerset_error_handlerParse errorCompile errorregister()Fatal errorAllowed memory size exhaustedClass not foundnewset_error_handlerexit()die()set_error_handlerE_ERRORE_PARSEE_CORE_ERRORE_COMPILE_ERRORE_USER_ERRORset_error_handlerApp::init()error_reporting(E_ALL)php
// 在入口文件 public/index.php 最开头插入：
error_reporting(0);
trigger_error('This shows up', E_USER_NOTICE); // ✅ 被 TP 捕获
trigger_error('This does NOT show up', E_USER_ERROR); // ❌ 白屏，TP 无响应
register_shutdown_functionFatal errorregister_shutdown_functionerror_get_last()public/index.phprequire __DIR__.'/../thinkphp/start.php';think\initializer\Errorfile_put_contentsphp
register_shutdown_function(function () {
if ($error = error_get_last()) {
$type = $error['type'] ?? 0;
if (in_array($type, [E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR, E_USER_ERROR])) {
$msg = sprintf("[%s] %s in %s on line %d",
$error['type'], $error['message'], $error['file'], $error['line']);
error_log($msg . PHP_EOL, 3, __DIR__ . '/../runtime/logs/fatal-' . date('Y-m-d') . '.log');
}
}
});
display_errorslog_errorsdisplay_errorslog_errors = Onerror_logphp.inierror_logphp_admin_value[error_log]error_log/dev/stderrapp_debug = true