使用bcrypt对比数据库存储哈希与用户登录明文密码的问题求助

核心逻辑说明 #

bcrypt是单向哈希算法，无法通过哈希反推明文，正确的校验逻辑是：

1. 登录时先根据用户名/邮箱查询出数据库中存储的对应密码哈希值
2. 调用bcrypt.compare(用户输入的明文密码, 库中存储的哈希)得到布尔结果，判断是否校验通过
   你更新后的登录代码逻辑符合规范，不需要调整，问题出在其他环节，可按以下顺序排查：

问题排查方向 #

• 确认代码是否正确部署生效
  你最初的错误代码逻辑是直接将用户输入的内容作为密码值进行SQL查询匹配，所以输入哈希值时刚好和库中存储的内容匹配就能登录，输入明文则无法匹配。如果更新代码后还是出现该现象，先确认新版本代码是否已经正确上线运行，没有缓存旧版本代码。
• 排查注册环节哈希生成逻辑
  注册时必须调用bcrypt.hash(用户输入的明文密码, 迭代轮数)生成标准bcrypt哈希后再存入数据库，不能直接存储明文、也不能用其他加密算法生成的哈希存入。如果注册环节生成哈希时使用的bcrypt版本、迭代轮数和登录环境不兼容，也会导致对比失败。
• 排查数据库密码字段存储规则
  bcrypt生成的哈希固定长度为60位，如果你的数据库password字段长度设置小于60位，会导致哈希被截断，后续对比必然失败。同时要确认字段是否设置了自动转义、大小写转换等规则，导致存入的哈希和生成的哈希不一致。
• 排查明文密码处理规则
  注册和登录环节如果对用户输入的明文密码做了不同的预处理（比如一方自动去除首尾空格、另一方没有，或者两侧编码格式不一致），会导致bcrypt.compare的输入明文和注册时的明文不一致，对比失败。

快速调试方法 #

可以临时添加日志打印关键值验证问题：

exports.Authenticate = async function(data) {
  try {
    console.log('用户输入的明文密码：', data.Password)
    const result = await pool.query(`SELECT "password" FROM ${config.MASUSER}.Users WHERE "Email" = $1 AND "Status" = $2`, [data.Email, data.Status])
    if (!result.length) {
      console.log('未查询到对应用户')
      return false
    }
    console.log('库中取出的哈希值：', result[0].password)
    const compareRes = await bcrypt.compare(data.Password, result[0].password)
    console.log('bcrypt对比结果：', compareRes)
    return compareRes
  } catch (err) {
    console.error('登录报错：', err)
    return false
  }
}

运行后查看日志即可快速定位是查询环节、哈希存储环节还是对比环节的问题。

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