ThinkPHP 的 validate()->batch() 不会自动调用 _check 方法，仅支持内置规则和 public 自定义方法；需将校验逻辑改为 public 方法并注册到 rule 数组中，才能在 batch 模式下正确返回多条错误信息。
ThinkPHP 的 validate()->batch() 不会自动触发 _check 方法
直接调用 $this->validate($data, $rule, [], true) 并开启 batch 模式，确实能返回多条错误，但前提是规则必须是数组格式定义的（如 ['name|姓名' => 'require|alphaNum']），而自定义验证方法 _check 是在模型或验证器类里写的独立逻辑，batch 模式默认不识别它——它只走内置规则和闭包验证，不反射调用私有/保护方法。
常见错误现象：batch=true 时，_check 完全没执行，或者只报一条“验证失败”，根本看不到多条错误。
- 必须把
_check对应的逻辑显式转成闭包或验证器类里的公共方法，并注册进规则数组 - 如果坚持用
_check，就得绕过batch，自己循环调用validate()单条校验再聚合结果 -
validate()的第三个参数（message）在batch=true下会被忽略，错误文案只能靠规则定义里的|分隔写死或用语言包
用验证器类 + scene + batch(true) 正确组织多字段自定义检查
推荐做法：别在控制器里硬塞 _check，而是新建一个继承 think\Validate 的验证器类，在里面定义 checkAge、checkEmailUniq 这样的公共方法，然后在 rule 数组里用 'age' => 'checkAge' 引用。
这样 batch(true) 才能识别并批量执行每个字段的自定义逻辑，且每条失败都计入最终错误列表。
立即学习“PHP免费学习笔记（深入）”；
- 验证器类方法必须是 public，返回 bool；返回 false 时，对应字段就记为失败
- 方法参数固定为
($value, $rule, $data, $field)，其中$data是整条数据，可用于跨字段检查（比如确认密码一致性） - 错误提示用
message数组配，键名要跟字段一致，支持占位符：'email' => '邮箱已被注册' - 场景（
scene）可用来分组启用部分规则，避免每次全量校验
class UserValidate extends Validate
{
protected $rule = [
'name' => 'require|alphaNum',
'email' => 'require|email|checkEmailUniq',
'age' => 'number|checkAge',
];
protected $message = [
'name.require' => '姓名不能为空',
'email.checkEmailUniq' => '邮箱已被注册',
'age.checkAge' => '年龄必须在 18-65 之间',
];
public function checkEmailUniq($value, $rule, $data, $field)
{
return Db::name('user')->where('email', $value)->count() === 0;
}
public function checkAge($value, $rule, $data, $field)
{
return $value >= 18 && $value <= 65;
}
}
validate()->batch(true) 返回的是二维数组，不是字符串
很多人卡在取错结果：batch=true 时，validate() 成功返回 true，失败返回形如 ['name' => ['姓名不能为空'], 'email' => ['邮箱已被注册']] 的关联数组，而不是单个字符串错误信息。
如果你直接 echo $result 或丢给前端 JSON，会出 warning 或空值——因为 PHP 默认把数组转成 Array 字符串。
- 务必先
is_array($result)判断是否失败，再处理 - 前端需要扁平化错误时，可用
array_merge(...array_values($result))合并所有字段的错误消息 - 注意：同一个字段可能有多个错误（比如
require|email|checkEmailUniq全挂了），$result['email']是数组，不是字符串 - TP6.1+ 支持
failException参数，设为false才返回数组；默认为true会抛异常，batch 模式下也一样
批量验证性能差？别让 checkXxx 方法重复查库
自定义方法里频繁查数据库（比如每个 checkEmailUniq 都执行一次 SELECT COUNT(*)）会导致批量验证变慢，尤其字段多、并发高时明显。
根本原因：batch 模式仍是逐字段调用验证方法，不是一次性收集所有待检值再统一查。
- 把多个待校验值提前 collect 起来，例如所有 email 值先用
array_column($dataList, 'email')提取，再一次性WHERE email IN (...)查询去重 - 在验证器构造函数或
scene初始化时预加载依赖数据，避免每个字段都查 - 对非关键字段（如昵称唯一性）可降级为异步检查，不在批量验证阶段强求
- TP6 的
Validate不支持“预检钩子”，所以得手动在验证前做一次集中预处理，再把结果传入验证上下文（比如用$this->data或临时属性缓存）
$data 参数里有没有你需要的其他字段值，别一上来就查库。 
