ThinkPHP如何配置自定义异常码_ThinkPHP业务错误标准化教程【教程】-ThinkPHP-PHP中文网

必须重写 app/exception/Handler.php 的 render 方法，判断 BusinessException 并返回带 code 字段的 JSON 响应；需实现 ExceptionHandlerInterface 接口，避免修改框架类，统一抛出封装 HTTP 状态码与业务码的自定义异常。

thinkphp如何配置自定义异常码_thinkphp业务错误标准化教程【教程】

ThinkPHP 的 `render` 方法怎么改才能返回自定义错误码

ThinkPHP 默认异常处理会返回 500 状态码和 HTML 错误页，业务场景下需要统一返回 JSON 格式、带 code 字段的结构（如 {"code": 1001, "msg": "用户未登录"}），必须重写 render 方法。不改这里，所有异常都走默认逻辑，自定义码无从谈起。

实操建议：

在 app/exception/Handler.php 中重写 render 方法，先判断是否为业务异常（比如继承自自定义基类 BusinessException），再构造响应
别直接修改 think\exception\Handle 类——它会被框架覆盖更新，改了白改
注意区分 HTTP 状态码（如 401/403）和业务码（如 1001），前者控制浏览器行为，后者供前端判断逻辑分支
如果用了多应用模式，确保每个应用的 Handler 都已配置，否则子应用仍走默认逻辑

如何定义和抛出带业务码的异常

不能靠 throw new Exception('xxx')，那样无法携带结构化 code。必须用自定义异常类封装业务码、消息、HTTP 状态码三要素。

实操建议：

新建 app/exception/BusinessException.php，继承 \think\Exception，构造函数接收 $code、$message、$httpCode = 200
在控制器或服务中，用 throw new BusinessException(1002, '参数缺失', 400) 抛出，而不是 return json(['code'=>1002]) —— 后者绕过异常处理链，日志、监控、统一拦截全失效
避免把数据库错误码（如 MySQL 的 1062）直接当业务码暴露给前端，应做映射：1062 → 2005（重复手机号）
不要在异常消息里拼接敏感数据（如 "用户 {$uid} 余额不足"），防止日志泄露

为什么 `config/exception.php` 里的 `handle` 配置不生效

ThinkPHP 6.0+ 默认启用「异常处理器自动发现」，即使你配了 'handle' => \app\exception\Handler::class，若该类没实现 think\contract\ExceptionHandlerInterface 或命名空间不对，框架会静默回退到默认处理器，且不报错。

实操建议：

确认 Handler.php 类开头有 use think\contract\ExceptionHandlerInterface;，并声明 implements ExceptionHandlerInterface
检查 config/exception.php 中的 handle 键值是否拼写正确，常见错误是写成 handler 或漏掉反斜杠
运行 php think clear:config 清缓存，TP 不会热重载异常配置
临时加一行 file_put_contents('/tmp/handler.log', 'hit'); die; 到 render 方法开头，验证是否真被调用

JSON 响应里 `code` 字段始终是 0 或 500 怎么办

大概率是异常没被捕获进自定义 Handler，或者 render 方法里没正确提取业务码。ThinkPHP 的 render 返回值必须是 Response 实例，手动 return json([...]) 会导致框架后续逻辑中断，code 字段可能被覆盖。

实操建议：

在 render 方法末尾强制返回：return response()->json(['code' => $code, 'msg' => $e->getMessage(), 'data' => []], $httpCode);
不要在 render 里调用 abort() 或 throw new HttpException()，这会再次触发异常处理，造成死循环
如果用了中间件做权限校验，确保它抛出的是你的 BusinessException，而非原生 think\exception\HttpException
开启调试模式（app_debug = true）时，部分异常会被框架包装成 ThrowableError，需在 render 中额外判断 $e instanceof \Throwable 并提取 getCode()