如何在JavaScript中重建验证Ruby on Rails的Bcrypt密码哈希

问题背景 #

需要将存量Ruby on Rails项目迁移至Node.js技术栈，原项目使用BCrypt算法实现密码哈希存储，要求Node.js侧完全复现原哈希生成、校验逻辑，无需重置存量用户密码即可直接登录。
已知测试信息：

• 明文测试密码：Test1234
• 数据库存储对应哈希值：$2a$11$j2IA8cPRFFC4YOXTl5kb9eF02fwNdLyFAPOvflQ3h/QdX8mE1SNK2
  原Ruby项目密码相关逻辑如下：

通用配置 #

COST = 11
SALT = 1234567890

哈希生成逻辑 #

def password_hash(password)
  pwd = "#{password}#{SALT}"
  ::BCrypt::Password.create(pwd, cost: COST)
end

哈希校验逻辑 #

def password_match?(password = nil)
  password ||= @params[:password]
  encrypted_password = get_encrypted_password
  return false if !encrypted_password || encrypted_password.size < 8

  pwd = "#{password}#{SALT}"
  BCrypt::Password.new(encrypted_password) == pwd
end

def get_encrypted_password
  return unless @account
  @account.encrypted_password
end

实际校验时出现异常：按照代码逻辑拼接得到待校验字符串Test12341234567890后，无论是用在线BCrypt工具校验，还是使用Node.js生态bcrypt包的compare方法校验，均返回匹配失败。 #

核心原因 #

匹配失败主要由两个容易忽略的细节导致：

• BCrypt版本前缀兼容问题：Ruby生态的bcrypt gem默认生成$2a$前缀的哈希，而Node.js生态常用的原生bcrypt包（基于C语言libxcrypt实现）仅对$2b$前缀的哈希做标准兼容处理，对旧版$2a$前缀哈希存在逻辑偏差，会直接返回不匹配结果。
• 固定拼接密钥（pepper）一致性问题：你代码中命名为SALT的常量本质是哈希胡椒（pepper），是和明文密码拼接的固定密钥，并非bcrypt算法自动生成的随机盐。如果迁移时该值存在类型转换误差（比如Ruby侧带前后不可见空白、编码格式差异、作用域取值错误），拼接后的待哈希字符串和原逻辑不一致，就会校验失败。

另外公开的在线BCrypt工具实现参差不齐，大量工具未兼容$2a版本旧哈希，不能作为校验依据。
注：BCrypt算法默认仅处理输入字符串的前72字节，超出部分会被截断，你的测试用例拼接后仅18字节不会触发该问题，长密码场景注意两边逻辑保持一致即可。 #

Node.js 端兼容实现方案 #

推荐使用纯JavaScript实现的bcryptjs包，避免原生C绑定包的前缀兼容问题，无需修改存量哈希数据即可直接校验。

1. 安装依赖

npm install bcryptjs

2. 实现和Ruby侧完全一致的逻辑

const bcrypt = require('bcryptjs');

// 配置项和Ruby侧完全保持一致
const BCRYPT_COST = 11;
// 注意：该值为固定拼接密钥，不是bcrypt随机盐，请和Ruby侧原值逐字节确认一致
const PASSWORD_PEPPER = '1234567890';

/**
 * 生成密码哈希，逻辑对齐Ruby侧password_hash方法
 * @param {string} password 明文密码
 * @returns {string} BCrypt哈希值
 */
function generatePasswordHash(password) {
  const pwd = `${password}${PASSWORD_PEPPER}`;
  return bcrypt.hashSync(pwd, BCRYPT_COST);
}

/**
 * 校验密码匹配，逻辑对齐Ruby侧password_match?方法
 * @param {string} password 用户输入明文密码
 * @param {string} storedHash 数据库存储的哈希值
 * @returns {boolean} 是否匹配
 */
function verifyPassword(password, storedHash) {
  if (!storedHash || storedHash.length < 8) {
    return false;
  }
  const pwd = `${password}${PASSWORD_PEPPER}`;
  // 若必须使用原生bcrypt包，打开下一行做前缀归一化即可
  // const normalizedHash = storedHash.replace(/^\$2a\$/, '$2b$');
  // return bcrypt.compareSync(pwd, normalizedHash);
  return bcrypt.compareSync(pwd, storedHash);
}

// 测试用例验证
const testPassword = 'Test1234';
const testHash = '$2a$11$j2IA8cPRFFC4YOXTl5kb9eF02fwNdLyFAPOvflQ3h/QdX8mE1SNK2';
console.log(verifyPassword(testPassword, testHash)); // 输出true即为逻辑正确

异常排查步骤 #

如果测试仍不通过，按以下顺序排查：

• 在Ruby侧执行puts "Test1234#{SALT}".bytes，打印拼接后字符串的每个字节值，和Node侧Buffer.from(Test1234${PASSWORD_PEPPER})输出的字节数组逐位对比，排除不可见字符、编码差异问题。
• 确认Ruby侧bcrypt gem版本，若为3.0以下的旧版本，可先升级gem版本后再做校验，新版本对跨语言哈希兼容性更好。
• 不要用第三方在线工具做正确性校验，直接用两边本地代码跑测试用例验证结果。

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