TP6验证器失效主因是未正确启用:类未继承think\Validate、场景未显式调用、字段名不一致;require不校验空字符串需配合min:1等规则或自定义非空验证。

TP6请求参数验证失败,多数不是规则写错了,而是验证器没“活起来”——类没继承、场景没指定、字段名对不上,或者压根就没走验证器逻辑。
验证器类必须继承 think\Validate
不能直接用数组传给 validate() 函数。比如这样会失效:
validate(['email' => 'email'])->check($data)
框架会尝试反射类名,找不到类就跳过校验,不报错也不验证。
正确做法是新建一个 PHP 类,例如 app/validate/UserValidate.php:
- 必须 extends think\Validate
- protected $rule 是关联数组,键为字段名,值为规则字符串(如 'email' => 'require|email')
- 字段名要和 $data 数组的键完全一致:大小写、下划线、点号都不能差
scene 必须显式调用才生效
写了 protected $scene = ['login' => ['username', 'password']],但控制器里只写 $validator->check($data),那 username 根本不会被校验。
必须显式指定场景:
$validator->scene('login')->check($data)
多个场景可定义为二维数组:
['create' => ['name', 'email'], 'update' => ['name']]
没有默认全字段校验机制,不进 scene 就等于没写
required 不校验空字符串,容易漏判
原生 require 只判断 isset(),对 ''、'0'、'false' 这类值放行。
常见翻车场景:用户提交空昵称、零金额订单,验证却通过。
解决方式有三种:
- 组合规则:'nickname' => 'require|alphaNum|min:1'(min:1 强制至少一个字符)
- 前置清洗:input('post.nickname', '', 'trim') 再进验证器
- 自定义规则:public function ruleNonEmpty($value, $rule, $data, $field),返回 is_string($value) ? strlen(trim($value)) > 0 : !empty($value)
错误信息顺序乱、提示不显示?检查三处一致性
验证失败后 getError() 返回空或顺序错,大概率是字段名不统一:
- $rule 里的字段名
- $message 数组的键名
- $data 数组的实际键名
三者必须完全一致(包括大小写、下划线、驼峰)。例如:
配了下划线:['user_name' => '用户名不能为空'],但 rule 里写的是 'username' => 'require',错误提示就不会生效。
调试时可 dump($validator->getRule()) 和 $validator->getMessage(),逐项比对键名是否对齐。

















