thinkphp6异常由框架层接管,php原生异常仅作兜底;tp6仅自动路由exception子类,error需手动捕获;httpexception支持http状态码与json自动响应;仅框架异常可被中间件拦截。

ThinkPHP6异常捕获是框架层接管,PHP原生异常是语言层兜底
当你在ThinkPHP6中抛出一个未被捕获的异常时,框架会主动拦截并交由app/exception/Handler::render()处理,而PHP原生的set_exception_handler()只会在框架完全失效或异常逃逸出框架流程时才被触发——这决定了你看到的是友好错误页还是白屏或500。
打开public/index.php,在require引入框架前加一行:set_exception_handler(function($e) { echo 'PHP原生捕获:' . $e->getMessage(); });,然后在控制器里throw new \Exception('测试'),你会发现根本不会输出这句话——因为TP6的异常处理器已在早期注册并优先接管了控制权。
TP6只对Throwable子类做自动路由,PHP原生能捕获所有Error
PHP 7+把Fatal Error也纳入Throwable体系,但ThinkPHP6的Db::transaction()、中间件、路由等核心流程默认只监听\Exception类型;如果你在事务闭包里触发了TypeError(比如传错参数给strlen()),它会被TP6忽略,直接穿透到PHP原生handler,导致事务不回滚且无日志。
必须在自定义Handler::render()开头显式判断:if ($e instanceof \Error) { log()->error('Fatal error caught', ['trace' => $e->getTraceAsString()]); },否则这类错误只会写入PHP错误日志,框架完全无感知。
【PHP 8.0+必须用\Throwable而非\Exception来捕获全部异常】
TP6异常可携带HTTP状态码,PHP原生异常不能直接映射
ThinkPHP6内置的HttpException构造函数支持第四个参数传入HTTP状态码:throw new HttpException(403, '权限不足');,框架会自动将该码注入响应头;而原生Exception对象没有这个能力,即使你在render()里手动调用response()->code(403),也得自己解析异常类型才能决定是否设置。
更关键的是:TP6的HttpException在JSON接口场景下会自动触发application/json响应格式,而原生Exception无论请求头是什么,render()默认都走HTML分支——除非你手动写判断逻辑。
TP6异常能被中间件拦截,PHP原生异常绕过中间件链
第一步:在app/middleware/CheckAuth.php中加入if ($e instanceof \think\exception\HttpException && $e->getStatusCode() === 401) { return redirect('/login'); };
第二步:在控制器中throw new \think\exception\HttpException(401);
第三步:观察浏览器是否跳转——这说明异常确实流经了中间件栈;
第四步:换成throw new \Exception('unauthorized');再试一次,页面直接报500且不跳转——因为原生Exception不会进入TP6中间件异常处理通道,它被框架视为“不可控错误”,直接终止流程交由底层处理。
这就是为什么业务代码必须抛出框架异常类:只有它们才拥有完整的生命周期钩子。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











