Yii2 Users模块注册表单验证码validate()通过但save()失败问题

问题原因 #

核心问题在于Yii2的save()方法默认会自动调用validate()，而Captcha验证码的验证是一次性的：第一次调用validate()通过后，验证码会被标记为已使用，第二次验证（save()触发的）会直接失败。

解决方法 #

方法1：跳过save()的自动验证（推荐，前提是已完成完整验证） #

既然已经通过$user->validate()确保了所有字段（包括Captcha）的合法性，直接调用save(false)跳过验证逻辑即可：

if ($user->load(Yii::$app->request->post()) && $user->validate()) /* $user->validate() succeeds. */
{
    $user->hash = Yii::$app->security->generatePasswordHash($user->password);
    $user->auth_key = Yii::$app->security->generateRandomString();

    if ($user->save(false)) /* 跳过验证直接保存 */
    {
        // 后续业务逻辑
    }
}

方法2：通过场景控制Captcha验证范围 #

在User模型中定义验证场景，让Captcha仅在注册阶段验证，保存阶段不触发：

1. 模型中添加场景规则：

public function scenarios()
{
    $scenarios = parent::scenarios();
    // 注册场景包含Captcha验证
    $scenarios['register'] = ['username', 'email', 'password', 'captcha'];
    // 保存场景排除Captcha
    $scenarios['save'] = ['username', 'email', 'hash', 'auth_key'];
    return $scenarios;
}

public function rules()
{
    return [
        // 其他字段验证规则
        ['captcha', 'captcha', 'on' => 'register'],
    ];
}

2. 控制器中切换场景：

$user->scenario = 'register';
if ($user->load(Yii::$app->request->post()) && $user->validate())
{
    $user->hash = Yii::$app->security->generatePasswordHash($user->password);
    $user->auth_key = Yii::$app->security->generateRandomString();
    
    $user->scenario = 'save'; // 切换到保存场景，不再验证Captcha
    if ($user->save())
    {
        // 后续业务逻辑
    }
}

方法3：手动验证除Captcha外的字段 #

如果需要确保修改后的字段合法性，可以清除之前的错误，仅验证非Captcha字段：

if ($user->load(Yii::$app->request->post()) && $user->validate())
{
    $user->hash = Yii::$app->security->generatePasswordHash($user->password);
    $user->auth_key = Yii::$app->security->generateRandomString();

    // 清除之前的错误，仅验证除Captcha外的属性
    $user->clearErrors();
    $validAttributes = array_keys(array_diff_key($user->attributes(), ['captcha' => true]));
    if ($user->validate($validAttributes))
    {
        $user->save(false);
        // 后续业务逻辑
    }
}

内容的提问来源于stack exchange，提问作者anva