ThinkPHP 8.0 全局异常处理必须通过服务提供者注册，禁用 config/app.php 配置；Handler 类需实现 ExceptionHandlerInterface，render() 必须接收 Request 并返回 Response，report() 必须调用 parent::report()，CLI 环境需手动绑定。
ThinkPHP 8.0 的全局异常处理 Handler 不生效、报错或显示空白页，核心原因不是代码写得不对，而是框架机制已彻底重构——旧版 TP6 或更早的配置方式在 TP8 中全部失效，且不报错、不提示，直接静默回退到默认行为。
必须用服务提供者注册，不能配 config/app.php
TP8 已完全移除 config/app.php 中 exception_handle 或 app_exception 配置项的支持。你在该文件里写的任何异常处理器类路径，框架启动时根本不会读取，也不会报错，只会用内置处理器兜底。
- 正确做法：在
app/provider.php中返回绑定关系：return [ 'think\exception\Handle' => \app\exception\Handler::class ]; - 类必须实现
\think\contract\ExceptionHandlerInterface，不能只继承think\exception\Handle - 命名空间和文件路径要严格一致，比如
app\exception\Handler必须对应app/exception/Handler.php
render() 方法签名和返回值有硬性要求
TP8 强制要求 render() 接收 Request 实例并返回 Response 对象，否则会二次渲染、混入 HTML 模板，甚至返回空白响应。
- 方法签名必须是：
public function render(Request $request, Throwable $e): Response - 不能省略
Request参数，也不能用app('request')替代 - 必须显式返回
response()、json()或view()等生成的Response实例
例如 API 场景：return json(['code' => -1, 'msg' => $e->getMessage()], 500); - 禁止
echo、die、exit或返回字符串
report() 必须调用父类方法，否则日志全丢
很多开发者重写 report() 后只做钉钉通知或自定义记录，却忘了调用 parent::report($exception)，结果导致 Sentry、Log channel、SQL 错误统计、$ignoreReport 过滤等全部失效。
立即学习“PHP免费学习笔记（深入）”；
- 基础写法必须包含：
parent::report($exception); - 如需精简堆栈，应在调用父类前处理：
$trace = array_slice($e->getTrace(), 0, 10); - 敏感信息（如
$_POST、Authorization头）要在日志写入前过滤，避免泄露 - 推荐异步写日志：
Log::channel('daily')->error(...)，避免阻塞主流程
CLI 环境要手动绑定，Web 和命令行不共享配置
运行 php think run、单元测试或命令行任务时，框架不会自动加载 app/provider.php 的绑定，也不会读取 config/app.php 中的异常配置，因此你看到的仍是原生 PHP 错误堆栈。
- 解决办法：在命令入口文件（如项目根目录下的
think文件）顶部添加：App::bind('think\exception\Handle', \app\exception\Handler::class); - 若使用多应用模式（
APP_MULTI = true），每个子应用的app/provider.php都需单独配置 - 验证是否生效：在命令行中抛一个未捕获异常，看是否进入你的
report()方法
