ThinkPHP 6 中 catch 不到 ValidateException 是因实际抛出的可能是 \_ValidateException 或 check() 返回 false；统一响应需在 Handler::render() 中显式判断两类异常并返回 JSON，或改用主动校验 + getErrors() 获取字段级错误。
ValidateException 为什么 catch 不到或响应不统一
直接 catch (ValidateException $e) 大概率失败——ThinkPHP 6 默认抛出的是 \think\exception\ValidateException，但很多场景（尤其是上传校验）实际抛的是带下划线的 \think\exception\_ValidateException；而验证器手动调用 check() 失败时，根本不会抛异常，只返回 false。框架的「统一响应」只对抛出的异常生效，对 check() === false 这种情况完全无感知。
在 Handler::render() 中接管所有 ValidateException 变体
必须显式覆盖两类异常：标准 ValidateException 和内部 _ValidateException，它们都继承自 \think\Exception，但 render() 不会自动识别后者的语义。正确做法是在 app/exception/Handler.php 的 render() 方法开头加判断：
if ($e instanceof \think\exception\ValidateException || $e instanceof \think\exception\_ValidateException) {
return json([
'code' => 422,
'msg' => $e->getMessage(),
'data' => []
], 422)->header('Content-Type', 'application/json');
}
注意：getMessage() 返回的是拼接后的中文提示（如“username 必须输入”），不含字段键名；如需字段级结构，得放弃异常路径，改走 validate()->check() + getErrors() 主动校验模式。
控制器里主动校验并构造结构化响应更可控
依赖异常机制做统一响应，本质是把错误处理权交给了框架调度链，容易被中间件提前截断（比如缓存中间件已输出响应）。真正稳定的做法是放弃 $this->validate() 魔术方法，改用实例校验：
立即学习“PHP免费学习笔记（深入）”；
- 创建验证器实例：
$validate = new \app\validate\UserValidate(); - 手动执行：
$result = $validate->scene('login')->check($data); - 失败时立即返回：
if (!$result) { return json(['code'=>422, 'msg'=>'验证失败', 'errors'=>$validate->getErrors()]); } -
getErrors()返回形如['username' => ['用户名不能为空']]的二维数组，前端可直接映射字段
这个流程绕过了所有异常捕获链，不依赖 Handler，也不怕中间件干扰，适合 API 接口主干逻辑。
别忽略 validate() 的返回值类型差异
ThinkPHP 6 的 validate() 辅助函数行为已变：它默认返回布尔值，不是异常；只有开启 failException => true 才抛 ValidateException。而 failException 在全局配置中默认为 false，所以你写的 $this->validate($data, 'rule') 实际上什么也没抛，只是默默返回 false，后续代码继续执行，最终可能因空数据导致 DB 错误，掩盖了真正的验证问题。
统一响应的前提，是清楚当前这行 validate 调用到底走的是「返回布尔值」还是「抛异常」路径——查 config/validate.php 或验证器类里的 protected $failException = true; 设置，别凭印象写 try/catch。
