代码迁移后bcrypt.compare()登录验证失败问题求助

1. 确认bcrypt盐轮次与哈希逻辑一致性 #

• 检查用户模型中密码哈希的盐轮次参数，确保注册（pre-save钩子）和登录验证时使用的bcrypt版本、参数完全一致。比如注册时用bcrypt.hash(password, 10, ...)，迁移后有没有不小心改成其他数值？
• 核对模型的pre-save钩子代码，确保哈希逻辑没有变动，比如：

userSchema.pre('save', async function(next) {
  if (!this.isModified('password')) return next();
  this.password = await bcrypt.hash(this.password, 10);
  next();
});

重点确认是否正确使用await，避免把Promise对象存入数据库。

2. 验证数据库中密码哈希的格式与完整性 #

• 直接查询MongoDB中的用户文档，检查password字段值：正常bcrypt哈希以$2b$（或旧版$2a$）开头，长度固定为60位左右。如果存储的是明文、截断字符串或乱码，必然导致验证失败。
• 用Mongo Shell执行查询：db.users.findOne({email: "你的测试邮箱"}).password，对比旧数据库中同用户的哈希值是否完全一致。

3. 排查注册/登录时的密码字段传递问题 #

• 注册路由中，确认是否正确获取前端传入的密码（比如是否误用req.body.pass而非req.body.password），可在哈希前添加日志：console.log("待哈希密码:", this.password)，验证输入的正确性。
• 登录路由中，添加日志输出待验证的密码与数据库存储的哈希：console.log("待验证密码:", req.body.password, "存储哈希:", user.password)，排除前端/Postman传参错误（比如表单格式与JSON格式混淆导致未拿到密码）。

4. 检查bcrypt版本兼容性 #

• 对比新旧项目的package.json中bcrypt版本号，不同版本可能存在哈希格式兼容问题（比如旧版$2a$与新版$2b$的个别场景不兼容）。若版本不一致，优先回退至原版本测试。

5. 确认数据库迁移的完整性 #

• 检查新数据库的字符编码、驱动版本是否与旧环境一致，避免数据迁移时密码字段被意外截断或编码转换。比如MongoDB驱动版本差异可能导致字符串存储异常。

6. 排查异步逻辑错误 #

• 确保注册时的哈希操作是异步完成后再存入数据库：若pre-save钩子未正确使用async/await或回调，可能导致未完成哈希的Promise或undefined存入数据库，进而引发验证失败。

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