验证器类加载失败主因是命名空间与物理路径不匹配或未走Composer PSR-4自动加载；必须严格遵循PSR-4规范，确保路径、命名空间、类名、composer.json配置及dump-autoload执行全部正确。
验证器类加载失败，90% 是因为命名空间和物理路径不匹配，或没走 Composer PSR-4 自动加载流程。 ThinkPHP 6+ 不再用 Loader::addNamespace() 或手写 __autoload，所有验证器类必须严格遵循 PSR-4 规范，由 Composer 管理加载。手动 require、复制粘贴类文件、改命名空间大小写、漏写 .php 后缀，都会直接导致 Class "app alidateUserValidate" not found。
验证器类文件路径与命名空间必须完全对齐
ThinkPHP 不会“猜”你的类在哪——它只按 PSR-4 规则把命名空间转成路径。比如你要用 app alidateUserValidate，就必须满足：
- 文件路径是
app/validate/UserValidate.php（注意：目录名validate小写，文件名UserValidate.php首字母大写） - 文件顶部声明
namespace app alidate;（不能是App alidate、appValidate或漏掉） - 类名必须是
class UserValidate extends hinkValidate（不能叫UserValidator或继承错基类） - 确保
app/目录已注册到composer.json的psr-4段中："app\": "app/"
composer dump-autoload -o 是必执行步骤，不是可选项
改完验证器类、新增类、调整命名空间后，不运行这条命令，Composer 就不知道有新类存在。常见误操作包括：
- 只改了文件，没运行
composer dump-autoload -o（-o表示生成优化映射，开发环境也建议加） - 在错误目录下执行命令（必须在项目根目录，即
composer.json所在层） - 编辑了
vendor/composer/autoload_*.php手动加映射——这些文件每次dump-autoload都会被覆盖 - 用 IDE 重命名类但没同步改命名空间或文件路径，导致映射断裂
验证器类被找到但规则不生效？检查是否调用了 check()
类能加载 ≠ 验证逻辑自动触发。ThinkPHP 的验证器是“被动执行”对象，必须显式调用 check() 才会跑规则。典型陷阱：
立即学习“PHP免费学习笔记（深入）”；
- 写了
new pp alidateUserValidate()却忘了接->check($data) - 用门面
validate(UserValidate::class)但没链式调用->check($data)，只拿到对象就结束了 - 控制器里用
$this->validate($data, 'UserValidate')，但第二个参数传了完整命名空间（应为类名字符串，如'UserValidate'，不是'app alidateUserValidate'） - 场景（
scene）设了但没在验证器里定义对应字段白名单，导致字段被跳过校验
自定义验证器目录（如 app/rules/）需要额外配置 autoload
默认只认 app/validate/。如果你把验证器放到 app/rules/ 下，想用 app
ulesLoginRule，就必须手动扩展 Composer 加载：
- 编辑项目根目录
composer.json，在"autoload": {"psr-4": {...}}里加一行："app\rules\": "app/rules/" - 注意命名空间末尾双反斜杠
\和路径末尾斜杠/必须对齐 - 运行
composer dump-autoload -o - 验证器类内仍需继承
hinkValidate，且规则写法不变
最容易被忽略的是：验证器类的加载和使用是两个独立环节。路径/命名空间错，连类都 new 不出来；路径对了但没调 check()，规则永远静默。别假设框架会替你补全调用链——ThinkPHP 6+ 的验证器设计就是“显式即安全”。
