ThinkPHP 表单验证必须使用规范命名与路径的验证器类（如app/validate/UserRegister），字段规则、提示、场景及自定义方法需严格遵循框架约定，否则易出现Class not found、静默失效或提示丢失等问题。
ThinkPHP 表单验证不能靠控制器里拼字符串规则硬扛，必须用验证器类（Validate 或其子类）承载规则、提示、场景和自定义逻辑——否则字段一多、条件一复杂，马上失控。
验证器类必须放对位置且命名规范
框架不会自动扫描任意目录下的验证类。错放路径或类名不匹配，Class not found 或静默走默认验证是常态。
- 正确路径：
app/validate/UserRegister.php（TP6+ 默认约定） - 类名必须与文件名一致：
UserRegister，且继承think\Validate - 命名空间必须为
app\validate；多应用模式下要对应前缀，如app\api\validate - 别塞进
app/common/或app/library/—— 这些目录不在验证类自动加载路径中
rule 和 message 必须成对定义，字段名要和 $data 键完全一致
验证失败却拿不到错误提示？大概率是字段名大小写、嵌套结构或前缀不一致。TP 的 check() 方法只认 $data 数组的键名，不自动映射表单 name 属性。
- POST 数据是
['user_name' => 'foo']，规则就得写'user_name' => 'require'，不是'username' - 嵌套数组如
addresses[0][name]，需先转成 PHP 数组再验证，且规则用通配符：'addresses.*.name' => 'require|length:2,20'（TP5.1+ 支持，但需开启 strict 模式） -
$message键必须是字段名.规则名格式，例如'email.email' => '邮箱格式不对'，漏掉点号或写错规则名，提示就丢 - 字段有多个规则（如
require|email|unique:user,email），出错时默认只报第一个失败项，想全量提示得开batch(true)并配合failException(false)
自定义验证方法必须是 public 且四参数签名
写了 checkEmailUnique() 却提示 method not exists？不是函数没写，是签名或可见性错了。
立即学习“PHP免费学习笔记（深入）”；
- 必须声明为
public function checkEmailUnique($value, $rule = '', $data = [], $field = '') - 少一个参数、顺序错、类型不匹配，
check()内部调用时直接报call_user_func_array(): Argument #1 must be a valid callback - 别在函数里 throw 异常，要用
$this->fail('提示信息')主动中断，否则流程不可控 - 需要读其他字段（比如“密码确认”比对），从
$data里取：$data['confirm_password']，不要另起input()或request
scene 不是开关，是字段白名单 + 规则叠加器
很多人以为 scene('edit') 就是“只校验 edit 场景的规则”，其实它先筛字段，再查规则——没列在 $scene['edit'] 里的字段，哪怕写了 rule/message，也彻底不参与验证。
- 场景数组必须是字段名列表：
'edit' => ['username', 'email']，不能用数字索引或带规则字符串 - 字段只在部分场景有额外限制（如注册时 email require，编辑时 optional），要用
append()动态加规则，而不是覆盖整个$rule - 调用时必须显式指定：
$validate->scene('register')->check($data)，不写scene()就走全部字段 - 数据库动态规则合并进模型时，也要按 scene 结构组织，否则
only(['title'])可能漏掉后加的字段
最易被忽略的是：验证器实例本身无状态，不携带 request/session 上下文。所有外部依赖（如模型查询、远程校验）必须通过构造参数传入，不能在方法里硬 new 或调全局函数——否则单元测试跑不通，高并发下还可能串数据。
