Node.js中bcrypt.compare始终返回false的登录验证问题求助

针对你遇到的登录时bcrypt密码对比失败的情况，以下是常见原因和具体排查方向：

1. 注册环节的哈希逻辑错误 #

最常见的问题是注册时未正确生成并存储哈希密码：

• 确保注册代码中await了bcrypt.hash的异步操作，否则会将Promise对象存入数据库，而非实际哈希字符串。示例正确代码：

// 注册路由示例
router.post('/register', async (req, res) => {
  const { email, password } = req.body;
  const hashedPassword = await bcrypt.hash(password, 10); // 必须await
  const user = new User({ email, password: hashedPassword });
  await user.save(); // 同样要await保存操作
});

• 检查哈希时的盐轮次（推荐10-12），确保注册和登录使用的是同一版本bcrypt。

2. MongoDB密码字段被截断 #

bcrypt生成的哈希固定为60个字符，如果数据库中password字段长度限制小于60，会导致哈希被截断，对比必然失败：

• 直接查询MongoDB中的用户文档，查看password字段长度是否为60。
• 检查Mongoose模型定义，确保password字段未设置maxLength限制，或限制值≥60：

const userSchema = new mongoose.Schema({
  email: { type: String, required: true },
  password: { type: String, required: true } // 不要加maxLength: 50这类限制
});

3. 输入密码存在多余空格或格式问题 #

用户输入的密码可能包含前后空格，或前端传输时引入了多余字符：

• 在登录代码中添加调试日志，打印输入的密码和存储的哈希：

console.log('输入密码:', password);
console.log('存储的哈希:', user.password);
console.log('哈希长度:', user.password.length);

• 对比输入密码是否和注册时一致，必要时在注册和登录环节都添加trim()处理：

const hashedPassword = await bcrypt.hash(password.trim(), 10); // 注册时
const isPasswordValid = await bcrypt.compare(password.trim(), user.password); // 登录时

4. bcrypt版本或环境问题 #

虽然你使用的是v5.1.1，但仍可能存在环境差异：

• 在项目根目录新建测试脚本，验证bcrypt本身的哈希和对比功能是否正常：

const bcrypt = require('bcrypt');

async function testBcrypt() {
  const testPassword = 'your-test-password';
  const hash = await bcrypt.hash(testPassword, 10);
  console.log('生成的哈希:', hash);
  const isMatch = await bcrypt.compare(testPassword, hash);
  console.log('对比结果:', isMatch); // 应输出true
}
testBcrypt();

如果脚本输出false，说明bcrypt安装有问题，可尝试重新安装：npm uninstall bcrypt && npm install bcrypt

5. 用户模型的中间件修改了密码 #

检查User模型是否有预存或转换中间件，意外修改了password字段：

• 查看是否有类似pre('save')的中间件对密码进行了二次处理，或toJSON/toObject选项错误地修改了字段值。

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