如何解决Express中用Mocha测试Bcrypt加密登录失败的问题

核心原因 #

你测试环境下密码哈希逻辑未正常执行，导致数据库直接存储明文密码，调用comparePassword时this.password取到的就是库中存储的明文，bcrypt.compare校验失败。
触发哈希失败最常见的原因是测试环境的配置缺失：

• 你的config文件中只配置了开发/生产环境的saltRounds，遗漏了测试环境的对应配置，config.saltRounds在测试环境下为undefined
• bcrypt.hash接收的盐轮数为非法值时会抛出错误，而你的hashPassword钩子未做异常捕获，Sequelize执行钩子失败后会直接跳过哈希步骤，将原始明文密码写入数据库
• 注册测试只断言了用户创建成功，未校验密码哈希逻辑是否生效，所以即使存了明文注册测试也能通过

修复步骤 #

1. 补全测试环境配置 #

检查你的config/config.js文件，确保所有环境（包括test环境）都配置了合法的saltRounds值：

// config/config.js示例
module.exports = {
  development: {
    saltRounds: 10,
    // 其他开发环境配置
  },
  test: {
    saltRounds: 10, // 补充测试环境的盐轮数配置
    // 其他测试环境配置
  },
  production: {
    saltRounds: 12,
    // 其他生产环境配置
  }
}

2. 完善哈希钩子的异常处理 #

修改hashPassword函数，增加参数校验和异常捕获，避免哈希失败时直接存储明文：

async function hashPassword(user) {
  const saltRounds = config.saltRounds
  // 提前校验配置合法性
  if (!saltRounds || typeof saltRounds !== 'number') {
    throw new Error('Invalid saltRounds configuration')
  }
  if (!user.changed('password')) {
    return
  }
  try {
    const hashedPassword = await bcrypt.hash(user.password, saltRounds)
    user.setDataValue('password', hashedPassword)
  } catch (err) {
    throw new Error(`Password hash failed: ${err.message}`)
  }
}

3. 增加测试环境的数据库清理逻辑 #

在测试启动文件setup.js中增加每个用例执行前的数据库重置逻辑，避免旧测试数据干扰：

// setup.js中添加
import { sequelize } from '../models'

beforeEach(async () => {
  // 强制同步数据库，清空所有表数据
  await sequelize.sync({ force: true })
})

可选优化 #

你也可以在注册测试中增加额外断言，确保密码不会明文返回：

// users.test.js的注册用例中添加
expect(res.body.user).to.not.have.property('password')

内容的提问来源于stack exchange，提问作者J. Unkrass