ThinkPHP表单验证失败但getError()返回空字符串，根本原因是错误信息未被正确收集：未触发完整校验流程、message键名不匹配规则、scene未包含字段、自定义规则未显式设置错误等。
ThinkPHP 表单验证失败后 $validate->getError() 返回空字符串
这是最常见的现象：明明规则没通过，$validate->getError() 却返回空，页面看不到任何提示。根本原因不是验证没跑，而是错误信息压根没被收集——ThinkPHP 默认只在 check() 返回 false 时才填充错误，而你可能直接用了 scene 或手动调用 rule，却忘了触发完整校验流程。
实操建议：
- 确保调用的是
$validate->batch(false)->check($data)，而不是仅$validate->rule(...)->check($data)；后者跳过场景和默认规则合并，错误池不生效 - 自定义验证类中，
protected $message必须是数组格式，键名严格对应规则字段（如'username.require' => '用户名不能为空'），错一个点（比如写成username.required）就匹配失败 - 如果用了
scene，检查该场景是否真包含对应字段的规则：protected $scene = ['edit' => ['username', 'email']]，若字段不在 scene 列表里，即使写了 rule 也不校验
ThinkPHP 6.x 中 Validate 的 message 数组键名规则
键名不是随便写的字符串拼接，它由「字段名 + 点号 + 验证类型」构成，且验证类型必须和实际使用的规则函数名完全一致（区分大小写、无下划线）。比如你写了 'email' => 'email|require'，那错误键就得是 'email.email' 和 'email.require'，写成 'email.emails' 或 'email.required' 都无效。
常见错误现象：
立即学习“PHP免费学习笔记（深入）”；
- 表单提交后报错但提示显示“undefined index: email.email” —— 实际是 message 键名没对上，PHP 警告被忽略，
getError()回退到空字符串 - 中文提示始终不出现，但英文默认提示出来了 —— 检查
message数组是否被其他逻辑覆盖（比如在构造函数里重置了） - 使用
in规则时，错误键应为'status.in'，不是'status.inList'或'status.in_array'
模板里输出错误提示时，$validate->getError('field') 不生效
getError('field') 只在验证已执行且该字段有错误时返回对应消息；如果验证根本没跑、或字段没参与校验、或校验通过了，它就安静地返回空。别指望它像 Laravel 的 $errors->first('field') 那样兜底。
使用场景建议：
- 不要在模板里反复调用
$validate->getError('username')，先在控制器里统一收集：$error = $validate->getError() ?: []，再传给模板 - 模板中用
isset($error['username']) ? $error['username'] : ''，比直接调方法更可靠，也避免重复触发验证逻辑 - 若需支持多语言，别把翻译塞进
$message数组，改用Lang::get($error['username'])动态解析，否则换语言时要维护两套 message
自定义验证规则 + 自定义错误信息，为什么 extend 里 return false 后没提示？
ThinkPHP 的自定义规则函数，返回 false 仅表示失败，**不自动绑定错误信息**。错误文案必须显式抛出或注入，否则 getError() 仍为空。
实操要点：
- 在
Validate类的extend方法里，不能只写return false，得配合$this->error手动设值：$this->error = '手机号格式不正确'; return false; - 如果规则是闭包形式，无法访问
$this，那就改用静态方法，并在方法内用Validate::fail('xxx')（TP6.1+）或直接 throw 新异常（需捕获处理） - 注意扩展规则的命名一致性：注册时叫
'phone'，规则字符串里就得写'mobile' => 'phone'，message 键也要是'mobile.phone'
最容易被忽略的是：自定义规则的错误注入时机必须在 check() 执行过程中，一旦校验结束，$this->error 就被清空。所以别在控制器里“补救式”调 $validate->setError()，它只是临时覆盖，不参与校验上下文。
