ThinkPHP 6 中 throw new Exception() 不走自定义异常处理，因未继承框架异常类；应抛出 HttpException 等子类并传入业务码（第四个参数），在 Handler::render() 中统一返回 JSON 响应。
ThinkPHP 6 的 throw new Exception() 为什么不走自定义错误处理？
默认情况下，throw new Exception() 不会触发 ThinkPHP 的业务异常响应逻辑，而是被底层 PHP 异常处理器捕获，最终返回 500 + 堆栈（开发环境）或空白页（生产环境）。真正能进 app\common\exception\Handler 并被 render() 处理的，是继承自 think\Exception 或更推荐的 think\exception\HttpException / think\exception\ValidateException 等框架内置异常类。
业务层应统一抛出 think\exception\HttpException 或自定义业务异常类（需继承它），才能确保被正确识别、响应格式化、且不泄露敏感信息。
- 不要直接
throw new Exception('参数错误') - 推荐写法：
throw new HttpException(400, '参数缺失', ['code' => 1001]) - 若需更多字段（如
data、trace_id），建议扩展一个BusinessException类，重写render()中的响应结构
如何在 render() 中统一返回 JSON 格式业务错误？
ThinkPHP 6 默认对 AJAX 请求返回 JSON，但非 AJAX 请求（如表单 POST）仍可能返回 HTML 错误页。要强制所有接口返回标准 JSON，必须在 app\common\exception\Handler 的 render() 方法中干预响应类型。
关键点不是“加个 json()”，而是提前判断是否为 API 场景，并覆盖原始响应：
立即学习“PHP免费学习笔记（深入）”；
- 检查请求是否属于 API 路由（例如路径以
/api/开头，或使用了api中间件） - 用
response()->json()构造统一结构，例如：['code' => $e->getCode() ?: 500, 'msg' => $e->getMessage(), 'data' => []] - 注意：不要直接
return json([...])，而要用return response()->json(...)->header('Content-Type', 'application/json')显式设头 -
$e->getStatusCode()可读取HttpException的 HTTP 状态码，普通Exception没有该方法，需兜底为 500
validate() 失败时怎么返回自定义错误码而不是默认 422？
ThinkPHP 的验证失败默认抛 ValidateException，HTTP 状态码为 422，且错误信息是字段+规则拼接的字符串（如 "username 必须输入"），不带业务码。要改成带 code 字段的结构，不能只改提示文字，得从异常抛出源头控制。
- 不要在验证器里写
return $this->fail('xxx')—— 这是控制器里用的，不是验证器内机制 - 在控制器中手动调用验证：
$result = $this->validate($data, $rule); if (true !== $result) { throw new ValidateException($result, 400, 1002); } - 或重写验证器的
failException属性：protected $failException = \app\common\exception\ValidateException::class;，然后在自定义ValidateException中注入code - 注意：框架内置
ValidateException的构造函数第三个参数才是业务错误码，第二个是 HTTP 状态码；顺序别传错
为什么线上环境 getCode() 总是 0？
PHP 的 Exception::getCode() 默认返回 0，除非你在 throw 时显式传入。ThinkPHP 不会自动把业务码塞进异常码里 —— 它只是个数字容器，你得自己填。
常见误解是以为设置 config('app.app_debug', false) 就能让框架帮你映射错误码，其实不会。所有业务码必须由开发者在抛异常时指定：
-
throw new HttpException(403, '权限不足', ['code' => 2003])→ 此处['code' => 2003]是$data参数，不是异常码 - 真正影响
$e->getCode()的，是构造函数**第一个整数参数**：new HttpException(403, 'xxx', [], 2003)—— 第四个参数才是异常码 - 所以标准写法是：
throw new HttpException(400, 'xxx', [], 1001)，然后在render()中用$e->getCode()取值 - 如果用了自定义异常类，务必在构造函数里把业务码传给
parent::__construct()的第四个参数
漏掉这个参数，getCode() 就永远是 0，前端拿到的 code 字段也就没法做分支处理 —— 这是最容易被忽略的细节。
