Yii2表单自定义验证失效主因是参数传递错误或验证未触发：内联验证器需严格三参数，独立类须声明public属性并调用parent::init()；确认字段在activeAttributes中、skipOnEmpty和when设置合理；each/exist验证器参数易错位。
Yii2 表单模型自定义参数验证出问题，常见不是逻辑写错，而是参数没传对、没生效或被跳过。调试时别急着改代码，先确认这几个关键点是否到位。
检查规则中参数是否正确传递
自定义验证器（内联函数或独立类）接收的参数必须完整且命名一致：
- 内联验证器签名必须是 function($model, $attribute, $params)，三个参数缺一不可；
$params是 rules() 中除前两个元素外的所有键值对，比如['mobile', 'PhoneValidator', 'strict' => true, 'country' => 'CN']，那么$params就是['strict' => true, 'country' => 'CN'] - 独立验证类中，参数需声明为 public 属性（如
public $strict = false;），并在init()中调用parent::init()，否则$this->strict会是 null - 若在 rules() 里写了
'message' => 'xxx'却没生效，检查是否漏了parent::init()—— 否则$this->message不会被自动赋值
确认验证是否真的触发了
很多“不报错也不校验”的情况，其实是验证根本没跑起来：
- 字段不在
activeAttributes列表里：确保该字段出现在当前scenario的scenarios()返回值中，或没被显式排除 - 被
skipOnEmpty跳过：默认为true，空字符串、null、0 都算“空”。若要强制校验（比如判断 0 是否合法），必须显式设'skipOnEmpty' => false - 被
when条件拦截：当when返回false，整个验证直接跳过，连skipOnEmpty都不看。调试时可临时注释掉when看是否恢复 - 字段名拼写错误：比如 rules 写的是
['user_id', ...]，但模型属性是$this->userId，会导致验证器找不到目标属性，静默失败
快速定位错误来源的实操方法
别靠猜，用这几招直接看到底卡在哪：
- 在自定义验证方法开头加
var_dump($this->$attribute); die;，确认值是否如期传入 - validate 后立刻打印：
var_dump($model->errors);，看有没有对应字段的错误条目；没有就说明没触发，有但内容不对就说明逻辑或 message 设置有问题 - 对独立验证类，在
validateAttribute()开头加echo "validating {$attribute}...";，确认类实例是否被创建并调用 - 开启 Yii 日志，设置
'log' => ['targets' => [['class' => 'yii\log\FileTarget', 'levels' => ['error', 'warning', 'info']]]]，在验证器里用\Yii::info("xxx", __METHOD__);追踪执行流
each 和 exist 验证器的典型参数陷阱
这两类嵌套/关联验证最容易因参数错位导致静默失败：
-
each的rule必须是数组，且第一个元素是验证器名，后续是配置项：✅['rule' => ['integer', 'min' => 1]]，❌['rule' => ['integer'], 'min' => 1]（min会挂在 each 上，不是 integer 的） -
exist的targetAttribute要配对准确：表单字段叫senderId，但 user 表主键是id，就得写'targetAttribute' => ['senderId' => 'id']，否则查user.senderId字段直接报错或返回空 - 验证失败时，
exist默认错误信息是 “不存在”，如果想提示更明确，必须加'message' => '请选择有效的发送人'
