ThinkPHP 8 自定义异常处理器捕获不到接口错误的核心原因是：抛出的异常未继承 think\Exception、app_exception 配置位置错误、render() 返回值非 think\Response 实例。
ThinkPHP 8 的自定义异常处理器捕获不到接口错误，通常不是代码写错了，而是框架根本没把异常交给你处理——它压根没接管那条请求链路。核心问题就三个：抛的异常类型不对、配置没落对位置、返回值不合法。
必须抛 think\Exception 子类，别用原生 Exception
TP8 只拦截继承 think\Exception 或其子类（如 HttpException、ValidateException）的异常。你在控制器里写 throw new \Exception('xxx')，框架直接跳过你的 render()，走 PHP 原生报错流程。
- 改成
throw new \think\exception\HttpException(500, '服务异常') - 参数校验失败用
throw new \think\exception\ValidateException('用户名不能为空') - 需要自定义结构时，建议继承
think\exception\HttpException，而不是原生Exception
app_exception 配置必须在 config/app.php 中
TP8 不再自动加载 app/exception.php，只认 config/app.php 里的 'app_exception' 键。很多人改了 Web 环境的配置，但命令行运行 php think run 或跑单元测试时，配置没生效。
- 确认
config/app.php的return []数组中包含：'app_exception' => \app\exception\ExceptionHandler::class - CLI 场景下需手动绑定：
在think文件顶部加一行：App::bind('think\exception\Handle', \app\exception\ExceptionHandler::class); - 多应用模式下，每个子应用的
config/app.php都要单独配，根目录配置无效
render() 必须返回 think\Response 实例
TP8 对 render() 返回值做严格校验。如果你写了 return json([...]) 或 echo 'error'，框架会二次包装成 HTML 页面，导致响应体混入模板 footer，前端收不到纯 JSON。
立即学习“PHP免费学习笔记（深入）”；
- API 接口统一用：
return json(['code' => -1, 'msg' => $e->getMessage()], 500); - Web 页面用：
return response($this->view->fetch('error/500'), 500)->contentType('text/html'); - 绝对不要在
render()里echo、exit、die或直接return []
验证是否真正接管：手动抛一个 HttpException
写个测试接口，只放一行：throw new \think\exception\HttpException(500, '接管测试');
访问它。如果看到你自定义的 JSON 或错误页，说明已生效；如果还是白屏或堆栈，说明上面三步至少有一处没到位。
