thinkphp 6/8 自定义异常处理类必须继承 think\exception\handle、重写 render() 方法，并在 config/exception.php 中正确配置 handle 键——缺一不可，否则静默失效；因 handle 是框架异常分发唯一入口，render() 是唯一可返回响应的地方，且签名须为 public function render(\think\request $request, \throwable $e): \think\response，配置键名必须为 handle，值为带命名空间的字符串类名，路径须严格匹配，修改后需清除配置缓存。
直接说结论：ThinkPHP 6/8 的自定义异常处理类必须继承 think\exception\Handle，重写 render() 方法，并在 config/exception.php 中正确配置 handle 键——缺一不可，否则静默失效。
为什么继承 think\exception\Handle 而不是 Exception？
因为只有继承 Handle 才能接入框架的兜底异常流程。直接 throw new \Exception() 或自定义 Exception 子类（如 BusinessException）不会自动触发你的处理器，除非你在 render() 里显式判断并处理它。
-
Handle是框架异常分发的唯一入口，render()是你唯一能返回 HTTP 响应的地方 - 继承
Exception只是定义“抛什么”，不解决“谁来接、怎么回” - TP6+ 已移除旧版
think\exception\ExceptionHandle，用错类名会报Class not found
render() 方法必须接收 Request 和 Throwable 参数
TP6 起签名强制为 public function render(\think\Request $request, \Throwable $e): \think\Response。漏掉 $request 或类型写成 Exception 会导致方法不被调用，页面仍显示默认错误页。
- 别写
Exception $e—— PHP 7+ 后所有异常都实现Throwable，Exception无法捕获Error类型 -
$request很关键：可用于判断是否 AJAX 请求、获取路由信息、区分 API/Web 场景 - 返回值必须是
\think\Response实例，不能echo、die或直接json_encode()
配置 handle 键不生效的三大硬坑
TP6/8 不报错、不提示，配置错就回退到默认处理器，非常隐蔽。
-
config/exception.php中键名必须是handle（不是exception_handle或handler） - 值必须是字符串类名，带完整命名空间，例如
app\exception\MyExceptionHandler::class，不能是对象实例或闭包（闭包只支持 TP5） - 类文件路径必须与命名空间严格匹配：
app\exception\MyExceptionHandler→app/exception/MyExceptionHandler.php，大小写敏感 - 改完务必运行
php think clear:config，否则缓存导致配置不加载
如何安全返回 JSON 或 HTML 响应？
别手动 header() 或拼接字符串，必须走 response() 工厂方法。
- API 场景：
return response()->json(['code' => 1001, 'msg' => $e->getMessage()], 500); - Web 页面场景：
return view('error/500', ['exception' => $e])->code(500);（模板路径是视图路径，不是物理路径） - 区分异常类型再响应：
if ($e instanceof \think\Exception\HttpException)拿状态码，if ($e instanceof \think\Exception\ValidateException)提取验证错误 - 切忌在
render()里再 throw 新异常，会触发无限递归，最终白屏
最易被忽略的是：多应用模式下，每个子应用都有独立的 config/exception.php，根目录配置对子应用无效；另外，业务异常类（如 BusinessException）必须在 render() 中主动识别，框架不会自动路由到它。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
