ThinkPHP表单验证报错提示不显示_自定义错误信息输出技巧-ThinkPHP-PHP中文网

ThinkPHP表单验证失败但getError()返回空字符串，根本原因是错误信息未被正确收集：未触发完整校验流程、message键名不匹配规则、scene未包含字段、自定义规则未显式设置错误等。

thinkphp表单验证报错提示不显示_自定义错误信息输出技巧

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' 都无效。

常见错误现象：

表单提交后报错但提示显示“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'