使用crypto/bcrypt验证密码时出现哈希不匹配错误求助

你遇到的问题是：生成密码哈希并存储后，验证时明明哈希字符串看起来完全一致，却触发crypto/bcrypt: hashedPassword is not the hash of the given password错误。以下是针对性的排查和修复方案：

1. 优先检查数据库Password字段长度 #

bcrypt生成的哈希字符串固定为60个字符，如果数据库中Password字段的长度设置小于60（比如varchar(50)），存储时会自动截断哈希，导致验证时对比的是不完整的哈希值，必然失败。

修复操作：
将数据库表中Password字段修改为varchar(255)（预留足够冗余），重新创建测试用户后再验证。

2. 排查是否存在隐形空白字符 #

虽然你打印的哈希看起来一致，但存储或读取过程中可能引入了换行、空格等隐形字符。可以在验证前添加长度和内容打印，确认哈希的完整性：

func (user *User) ValidatePassword(password string) bool {
    // 打印哈希长度和带引号的内容，方便识别隐形字符
    fmt.Printf("存储的哈希长度: %d, 内容: '%s'\n", len(user.Password), user.Password)
    err := bcrypt.CompareHashAndPassword([]byte(user.Password), []byte(password))
    return err == nil
}

如果存储的哈希长度不等于60，说明存在截断或额外字符，需要检查：

• ORM框架是否对字符串做了自动trim处理
• 序列化/反序列化过程中是否篡改了字符串

3. 修复验证函数的不合理逻辑 #

当前验证函数在失败时直接panic，会导致HTTP服务崩溃，这是生产环境绝对禁止的。简化并优化函数：

// 仅返回验证结果
func (user *User) ValidatePassword(password string) bool {
    return bcrypt.CompareHashAndPassword([]byte(user.Password), []byte(password)) == nil
}

// 或者返回错误，方便上层处理
func (user *User) ValidatePassword(password string) error {
    return bcrypt.CompareHashAndPassword([]byte(user.Password), []byte(password))
}

4. 确认存储流程无篡改 #

检查从NewUser生成哈希到存入数据库的全流程，确保没有中间步骤修改Password字段：

• 确认ORM模型的字段映射完全匹配
• 排查是否有钩子函数（如BeforeSave）意外修改了密码哈希

按以上步骤排查，最常见的根因就是数据库字段长度不足，建议优先检查这一项。

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