thinkphp验证器需显式调用validate()才生效，常见错误包括未调用、未拦截、规则配置不当、自定义规则未注册、批量验证未启用batch(true)等。
验证器类没生效，请求直接进控制器了
ThinkPHP 的验证器默认不会自动拦截，必须显式调用 validate() 或配置路由/控制器行为。常见错误是只定义了 app\validate\UserValidate 类，但控制器里没写 $this->validate($data, UserValidate::class)，或者漏了 return false; 拦截逻辑。
实操建议：
- 在控制器方法开头立即校验，别等查数据库之后再验
- 用
$this->validate($data, 'UserValidate')字符串形式更稳妥，避免命名空间加载失败 - 若想全局自动校验，需在中间件中统一处理，而非依赖控制器自觉调用
- 注意：命令行或 API 调试时，
input()获取的数据可能不含预期键，导致验证器跳过规则（如空数组传入）
required 和 require_if 混用导致必填判断失效
required 是硬性必填，而 require_if 依赖其他字段值动态触发。容易踩的坑是把两者逻辑写反，比如「当 type=2 时才需要 card_no」，却误写成 ['card_no'=>'required|require_if:type,2'] —— 实际上 required 会先执行并报错，根本走不到 require_if。
实操建议：
- 动态条件校验只用
require_if、require_unless、require_with等，去掉前置required - 多个条件组合时，用闭包验证器更可控：
function ($value, $rule, $data) { return $data['type'] === 2 ? !empty($value) : true; } - 测试时务必覆盖
type=1和type=2两种情况，别只测“有值”路径
自定义验证规则在 validate() 中不触发
自定义规则函数（如 checkMobile）写在验证器类里，但调用 validate($data, UserValidate::class) 时没生效，通常是因为没在 rule 数组中正确注册，或函数名拼写与规则名不一致。
实操建议：
- 规则名必须和方法名完全一致（包括大小写），且方法必须是
public，返回布尔值 - 在
rule中写成'mobile' => 'checkMobile'，不是'mobile' => 'check_mobile' - 若规则需传参（如
checkMobile:11），方法签名得是public function checkMobile($value, $rule, $data)，第三个参数才是原始数据数组 - 调试时可在自定义方法里加
trace()或dump()，确认是否被调用
批量验证失败时只返回第一个错误，前端显示不全
默认情况下，ThinkPHP 验证器遇到第一个失败规则就停止，$validate->batch(true) 才会收集全部错误。但很多人只在实例化时设，忘了在 validate() 调用前启用。
实操建议：
- 批量验证必须两步：先
$validate = new UserValidate(); $validate->batch(true);，再$validate->check($data) - 用
$validate->getError()取结果，它是关联数组，键为字段名，值为字符串错误信息 - 注意兼容性：TP6.0+ 支持
batch，TP5.1 需手动循环调用scene()或拆分验证 - 如果用了
scene场景，batch仍有效，但只校验当前场景包含的字段
验证器真正难的不是写规则，而是搞清它在哪一环介入、谁负责抛出异常、错误怎么透传给前端。特别是和中间件、API 资源类混用时，validate() 调用位置稍偏一点，整个拦截就失效了。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
