ThinkPHP验证器默认getError()不返回字段名，需用batch模式+getFailMsg()获取字段级错误；$message键必须为“字段名.规则名”格式；API应统一用response()返回结构化JSON，升级6.0后注意getError()返回格式变化。
ThinkPHP 的 validate 方法默认不返回错误字段名，只返回中文提示
这是最常被卡住的一点：前端需要知道是哪个字段（比如 email）校验失败，但 ThinkPHP 默认的 $validate->getError() 只返回字符串如“邮箱格式不正确”，没结构、没字段键名。根本原因在于验证器的错误信息是扁平字符串，不是键值对。
解决办法不是重写整个验证流程，而是用 Validate 类的 failException 和 batch 配合自定义错误格式：
- 开启
batch模式（['batch' => true]），让验证器一次性收集所有错误，而不是遇到第一个就停 - 关闭
failException（设为false），避免抛异常打断流程 - 手动调用
getFailMsg()—— 注意，这个方法在 6.0+ 版本中才返回带字段键的二维数组，5.1 需要自己从getError()解析或改用validate()->scene()->check()后手动映射
覆盖全局 Validate 配置时，message 键必须和规则字段严格对应
很多人在验证器类里写：protected $rule = ['name' => 'require|alphaNum']，然后配 protected $message = ['require' => '必填']，结果发现“name”字段报错时提示还是默认的“name 不能为空”。问题出在键名不匹配。
$message 的键必须是 "字段名.规则名" 或 "字段名.require" 这种完整路径形式，否则框架找不到对应项：
立即学习“PHP免费学习笔记（深入）”；
- 正确写法：
protected $message = ['name.require' => '用户名必填', 'email.email' => '邮箱格式不对'] - 错误写法：
['require' => '必填']（全局规则名会冲突，且无法区分字段） - 如果用了
scene，还要确保$scene中定义的字段名和$rule一致，否则$message键对不上
想统一返回 JSON 结构给前端？别直接 echo，走 response() + 自定义 format
直接 echo json_encode(...) 会绕过 ThinkPHP 的响应生命周期，丢失状态码、Content-Type、中间件逻辑。尤其在 API 场景下，前端可能收不到 422 状态码，导致错误处理失效。
推荐在控制器里统一拦截验证失败：
- 用
if (!$validate->check($data))判断 - 构造结构化返回：
return json(['code' => 422, 'msg' => '验证失败', 'errors' => $validate->getError()])—— 但注意：这仍是字符串，要字段级错误得用getFailMsg()或自行解析 - 更稳妥的是封装一个基类方法，把
$validate->getFailMsg()的结果按字段归并，例如：['email' => ['邮箱格式不对'], 'password' => ['长度不能少于6位']]
5.1 升 6.0 后 getError() 行为变化，老项目容易漏掉兼容处理
ThinkPHP 5.1 的 getError() 返回字符串数组（['邮箱格式不正确', '密码不能为空']），6.0+ 默认返回关联数组（['email' => '邮箱格式不正确', 'password' => '密码不能为空']）。如果你的前端 JS 正在用 errors[0] 取第一个错误，升级后会报 undefined。
检查点很具体：
- 确认当前版本：
think_version()输出是否 ≥ 6.0 - 验证器实例是否启用了
setScene()且该 scene 包含了你要校验的字段（否则getFailMsg()可能为空） - 若需兼容旧结构，可加一层转换：
array_values($validate->getError())，但建议趁机升级前端错误渲染逻辑，支持字段粒度
字段级错误不是锦上添花，是表单交互的底线——漏掉一个 email.require 的 message 键，用户就看不到邮箱框下的红色提示。
