ThinkPHP校验失败时需调用getError()获取字段级提示，其返回关联数组（键为字段名、值为提示语），前端通过name属性匹配渲染；关键要确保后端规则字段名、$data键名、HTML name三者完全一致。
ThinkPHP 表单提交后如何显示校验失败字段的提示？
校验失败时只返回 validate()->failException(true) 抛出异常，或 validate()->batch(true)->check() 返回布尔值，但默认不附带具体字段错误信息。必须手动调用 validate()->getError() 才能拿到字段级提示，且该方法只在 check() 返回 false 后有效。
-
validate()->getError()返回的是关联数组，键为字段名（如'username'），值为字符串提示（如'用户名不能为空'），不是 JSON 字符串，别直接json_encode丢给前端就完事 - 若用
scene切换场景，必须确保check()前已调用scene('xxx')，否则getError()可能返回空或错位字段提示 - 控制器中建议统一结构返回：
if (!$this->validate($data, 'User.create')) { return json(['code' => 0, 'msg' => '验证失败', 'data' => $this->validate->getError()]); }
怎么让 ThinkPHP 的 validate 错误提示对应到前端表单具体输入框？
关键不是后端“生成”提示，而是保证字段名完全一致：后端规则里定义的字段名（如 'email'）、$data 数组的键、HTML 表单 name 属性三者必须严格相同。哪怕多一个下划线、大小写不一致，getError() 返回的键就对不上，前端就找不到渲染位置。
- 避免用点号嵌套字段名（如
'user.email'），ThinkPHP 默认不支持这种写法校验；如需嵌套结构，得改用ValidateRule自定义规则或预处理$data - 前端接收
data后，建议用对象解构方式映射：const errors = response.data; Object.keys(errors).forEach(field => { const el = document.querySelector(`[name="${field}"]`); if (el) { el.setCustomValidity(errors[field]); el.reportValidity(); } }); - 如果表单用了 Vue/React，注意字段名是否被框架自动加了前缀（如
v-model="form.username"对应name="username"是 OK 的，但若绑定的是form.user.name就要手动 flatten 数据再校验）
实时校验（onblur / input）时，ThinkPHP 后端该怎么接？
ThinkPHP 本身不提供“实时校验接口”，你需要自己写一个轻量路由，接收单字段 + 值，调用 Validate 单条规则验证，并返回结构化结果。不能复用完整表单验证规则——因为批量规则可能含“确认密码需一致”这类跨字段逻辑，单字段调用会失效。
- 推荐做法：单独定义一个
SingleValidate验证器类，只写单字段规则（如'username' => 'require|alphaNum|length:3,16'），避免引用含:confirm或:in等依赖上下文的规则 - 接口示例：
public function checkField() { $field = $this->request->param('field'); $value = $this->request->param('value'); $rule = ['username' => 'require|alphaNum|length:3,16', 'email' => 'require|email']; $validate = Validate::make($rule); $result = $validate->check([$field => $value]); if (!$result) { return json(['valid' => false, 'msg' => $validate->getError($field)]); } return json(['valid' => true]); } - 注意：不要在实时校验里查数据库（如“用户名是否已存在”），否则并发高时易打满连接；真要查，加缓存或节流（前端 debounce 至少 300ms）
为什么 $validate->getError() 有时返回空，有时返回整个规则字符串？
常见于两种情况：一是没调用 check() 就直接取 getError()，二是规则定义用了中文冒号（如 '用户名：require'）或全角符号，导致解析失败，Validate 内部把整条规则当成了错误消息。
立即学习“PHP免费学习笔记（深入）”；
- 检查
app/validate/下验证器类中的rule数组，确保所有键是英文字段名，所有值是标准规则字符串（用英文冒号、竖线分隔），例如：'status' => 'in:0,1,2'，而非'状态' => 'in：0，1，2' - 调试时可临时加一行：
dump($this->validate->getRule());看实际加载的规则结构是否符合预期 - 如果用了动态规则（如
$validate->rule(['email' => $customRule])），务必确认$customRule是字符串类型，不是数组或 null
getError() 就彻底不可信。 
