Yii框架登录密码验证始终返回false及注册验证不通过问题求助

兄弟，我来帮你排查下这两个头疼的问题，先从最常见的坑说起！

一、登录密码验证始终返回false的原因及解决办法 #

• 数据库密码字段长度不够（最常见！）
  Yii的Yii::$app->security->generatePasswordHash()生成的哈希字符串（比如默认的bcrypt算法）长度大概在60字符左右，如果你的数据库password字段设置成了varchar(32)或者更短的长度，存储时哈希会被截断，导致验证时用完整密码和不完整的哈希对比，必然返回false。赶紧去修改数据库表结构，把password字段改成varchar(255)就解决了。
• 你的validatePassword方法写法冗余且有风险
  你现在每次验证都重复调用findByUsername($this->username)查询数据库，不仅没必要，还可能因为查询返回null触发错误。可以改成更简洁安全的写法：

public function validatePassword($password)
{
    // 先确认当前实例的密码字段不为空
    if (empty($this->password)) {
        return false;
    }
    return Yii::$app->security->validatePassword($password, $this->password);
}

另外原生password_verify()返回false也是同样的原因——哈希被截断了，Yii的验证方法底层其实也是依赖这个原生函数的。

二、注册时无法进入if($this->validate())的原因及排查方法 #

• RegistrationForm的验证规则配置不全
  你得检查RegistrationForm类里的rules()方法，是不是没给username、password设置必要的验证规则？比如用户名是否必填、是否唯一，密码长度是否达标等。参考示例配置：

public function rules()
{
    return [
        // 用户名和密码为必填项
        [['username', 'password'], 'required'],
        // 用户名不能重复，关联User表的username字段
        ['username', 'unique', 'targetClass' => '\app\models\User', 'message' => '该用户名已被注册'],
        // 密码长度至少6位
        ['password', 'string', 'min' => 6],
    ];
}

如果没有这些规则，或者输入的内容不符合规则（比如密码太短、用户名已存在），$this->validate()就会返回false。

• 打印验证错误信息快速定位问题
  可以在register方法里加一行代码，直接输出验证失败的具体原因：

public function register()
{
    if (!$this->validate()) {
        // 打印错误信息，方便排查
        var_dump($this->getErrors());
        exit;
    }
    // 后续注册逻辑...
}

这样就能直观看到是哪个字段没通过验证，针对性调整即可。

备注：内容来源于stack exchange，提问作者flavius08_80