getError()默认只返回首个错误字符串且不带字段名；需用batch(true)+getFailMsg()获取字段=>错误的关联数组，四者键名（字段、rule、message、data）必须完全一致。
为什么 $validate->getError() 总是返回空或单条字符串？
因为 getError() 默认只取第一个失败字段的第一条规则提示，且不带字段名；若没触发任何校验（比如 rule 字段名和 $data 键名不一致），它就返回空。这不是 bug，是设计如此——它本就不是为结构化输出准备的。
- 检查
$validate->getRule()和实际传入的$data键名是否完全一致（大小写、下划线、驼峰都不能差） - 用了
scene就必须先调用$validate->scene('xxx')，否则规则不生效，getError()也拿不到东西 - 不要在批量验证时还依赖
getError()，它在batch(true)下行为不可靠，该换getFailMsg()
如何拿到每个字段对应的错误信息（带字段名）？
必须启用批量模式，并使用 getFailMsg() —— 这是 TP6.1+ 唯一能稳定返回「字段 => 错误消息」映射的方法。它的返回值是关联数组，键就是字段名，值是字符串（非数组），适合前端直接消费。
- 调用前务必设
$validate->batch(true)，否则getFailMsg()返回空 - 别写
if (!$validate->check($data)) { return json(['errors' => $validate->getError()]); }，这只会传字符串 - 正确写法：
if (!$validate->batch(true)->check($data)) { return json(['errors' => $validate->getFailMsg()]); } - 注意：如果规则里用了
'username|用户名'这种描述语法，getFailMsg()的键仍是username，不是“用户名”
错误信息顺序乱、字段缺失、提示不对，怎么对齐？
ThinkPHP 不保证错误数组顺序等于 rule 定义顺序，也不自动做字段名映射。你看到的“错乱”，其实是字段名、rule 键、message 键三者没对齐导致的校验未触发或提示未匹配。
-
$message的键必须是'field.rule'格式，例如'email.email' => '邮箱格式不正确'，写成'email' => 'xxx'或'email.require'但 rule 里没 require，都会失效 - 调试时第一件事：在
check()前加dump($validate->getRule(), $validate->getMessage(), $data)，三者逐字比对 - 前端传
user_name，后端 rule 就得写'user_name' => 'require|email'，message 也要用'user_name.require'，不能指望框架自动转换 - 需要固定输出顺序？别依赖数组遍历顺序，显式定义字段白名单：
$fields = ['username', 'email', 'password']; foreach ($fields as $f) { $err = $errors[$f] ?? ''; }
API 响应中怎么返回规范的 422 错误结构？
直接 echo json_encode() 会丢失状态码、Content-Type 和中间件逻辑，前端收不到标准 422，调试也难定位。ThinkPHP 的 json() 方法才是正确出口。
立即学习“PHP免费学习笔记（深入）”；
- 永远用
return json(['code' => 422, 'msg' => '验证失败', 'errors' => $validate->getFailMsg()])，不要自己拼 JSON - 避免在
json()前调用header()，否则报 “headers already sent” - 如果用了全局验证中间件，检查里面是否硬编码了
'Input validation failed'—— 这不是框架原生错误，是你自己或扩展写的 - 日志审计建议加中间件捕获
ValidateException，记录 IP、URL、原始参数，而不是只看返回给前端的内容
