应复用自定义验证器类而非重复写@Validator注解，通过继承Hyperf\Validation\Validator并用@Component标记，支持params动态传参实现多场景复用，避免硬编码规则或滥用validate()方法。
Hyperf 里重复写 @Validator 注解怎么办
直接复用已有验证逻辑，别每个 Controller 方法都手写一遍 @Validator。Hyperf 的注解验证器本身支持自定义验证器类，把通用规则（比如手机号、身份证号、非空数组）抽成独立的 Validator 类，再通过 @Validator 引用即可。
常见错误是把验证逻辑硬编码在 @Validator 的 rules 参数里，例如：@Validator(rules={"mobile": "required|regex:/^1[3-9]\d{9}$/"})——这种写法无法复用，改一处要搜全项目。
- 新建类继承
Hyperf\Validation\Validator，重写getRules()和getMessages() - 在
@Validator中用validator=MyMobileValidator::class指定，而非写死rules - 注意：自定义验证器类必须被
@Component注解标记，否则容器找不到
多个接口共用同一套字段校验，但参数结构不同
比如 createUser 和 updateUser 都要校验 email、password，但前者要求 username 必填，后者允许为空。这时候不能只靠一个验证器类硬编码全部规则。
推荐做法是让验证器支持运行时传参，利用 Hyperf\Validation\Validator 构造函数接收上下文参数：
#[Validator(validator: UserFormValidator::class, params: ['scene' => 'create'])]
public function create(RequestInterface $request) { ... }
然后在 UserFormValidator 的 getRules() 里根据 $this->params['scene'] 动态返回规则数组。避免为每个场景新建一个验证器类。
-
params会自动注入到验证器实例的构造参数中，无需手动 resolve - 不要在
getRules()里做 heavy 逻辑（如查 DB），验证器应轻量、无副作用 - 如果场景差异过大（比如字段名都不同），优先考虑拆成两个验证器，而不是塞满 if 分支
自定义验证器里调用 validate 方法报错 Call to undefined method validate()
这是混淆了验证器类和验证服务的用法。自定义验证器类（如 MyValidator extends Validator）本身不提供 validate() 方法，它只是规则和提示语的载体；真正执行验证的是 Hyperf\Validation\Contract\ValidatorFactoryInterface。
如果你在控制器或 service 里想手动触发验证，应该这样写：
$validator = $this->validatorFactory->make($data, $rules, $messages);
if ($validator->fails()) { ... }
而不是在自定义验证器内部调用 $this->validate(...)。
-
Validator子类只负责声明规则和消息，不负责执行 - 若需复用验证逻辑做手动校验，建议单独封装一个 service 方法，而不是塞进验证器类
- 注意
$rules数组的键必须和待验证数据的 key 对齐，否则fails()可能静默通过
验证失败时错误信息中文乱码或格式不统一
Hyperf 默认使用 hyperf/translation，但很多项目没配好语言包路径或没启用中文 locale。最直接的表现是错误信息里出现 :attribute、:min 这类占位符没被替换。
检查点有三个：
- 确认
config/autoload/translation.php中'locale' => 'zh_CN'已设置 - 确认
lang/zh_CN/validation.php文件存在且返回的是完整翻译数组（不是空数组或语法错误） - 验证器类里
getMessages()返回的键必须和lang/zh_CN/validation.php里的 key 匹配，例如'email.required' => '邮箱不能为空'
另外，如果用了 scene 动态规则，getMessages() 也要按 scene 分支返回对应提示，否则容易漏翻译。
