Ruby on Rails中使用BCrypt验证现有密码哈希失败问题排查

1. BCrypt格式推测的可靠性 #

$2a$12$xxxxyyyy完全符合BCrypt的标准哈希格式，你的推测是可靠的。BCrypt哈希的结构为$<版本>$<成本因子>$<盐值+哈希值>，其中2a是BCrypt的常见版本标识，12是计算成本因子，后面的字符串是盐值与哈希结果的组合。

2. 相同密码+盐生成相同哈希的假设 #

正常情况下这个假设成立，但前提是所有哈希参数完全一致：包括密码的字符编码、是否使用pepper、BCrypt版本、成本因子等，只要有一项不同，生成的哈希就会不一致。

3. 你的验证操作是否有误 #

你写的Ruby验证代码是标准用法，没有错误：

password = ::BCrypt::Password.new("$2a$12$xxxxyyyy")
verify = password == "known_plaintext_password"

手动生成哈希的代码逻辑也没问题：

bcrypt = ::BCrypt::Password.new("$2a$12$xxxxyyyy")
::BCrypt::Engine.hash_secret("known_plaintext_password", bcrypt.salt)

验证失败的问题不在代码本身，而是跨平台实现的兼容性或额外处理（如pepper）导致的。

4. Pepper的推测合理性 #

非常合理。很多系统会在密码哈希前添加全局密钥（pepper），通常是拼接在明文密码的前后（比如pepper + password或password + pepper），再进行哈希。如果原系统使用了pepper，而你验证时没有添加，必然会导致哈希不匹配。

5. .NET与Ruby BCrypt的兼容性问题 #

确实存在常见的兼容性差异，核心点在字符编码：
-.NET默认使用UTF-16LE（Unicode）编码处理字符串，而Ruby的BCrypt库默认使用UTF-8编码。相同明文密码，两种编码生成的字节序列不同，最终哈希结果自然不一致。

排查建议 #

1. 测试编码差异：尝试将明文密码转成UTF-16LE编码后再验证：

   password = ::BCrypt::Password.new("$2a$12$xxxxyyyy")
   verify = password == "known_plaintext_password".encode('UTF-16LE')
   

   如果验证成功，说明问题出在编码上。

2. 排查pepper存在性：如果编码调整后依然失败，大概率原系统使用了pepper。需要确认原系统中pepper的内容和拼接方式（前置或后置），然后在验证时添加：

   pepper = "原系统的pepper值"
   combined_password = pepper + "known_plaintext_password" # 或 password + pepper，需匹配原系统逻辑
   verify = password == combined_password.encode('UTF-16LE') # 若编码同时存在问题
   

3. 确认BCrypt版本细节：少数情况下，.NET的BCrypt实现可能对$2a$版本的处理有细微差异，你可以尝试用Ruby生成$2a$版本的哈希对比，或检查原系统是否实际使用了$2y$版本（部分.NET库会自动转换版本标识）。

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