服务器升级后Rails 4.1应用认证功能失效求助

核心原因 #

服务器升级后数据库编码从utf8改为latin2，导致BCrypt存储的密码哈希值被转码损坏。BCrypt生成的哈希是包含特殊字符的UTF-8字符串，而latin2是单字节编码，无法正确存储这些非latin2字符，哈希值被篡改后，valid_password?校验自然失败，更新密码时BCrypt也会因识别不了损坏的哈希抛出BCrypt::Errors::InvalidHash错误。

排查步骤 #

• 直接查询数据库对比哈希值：
  执行SQL语句查看当前用户的哈希值：

  SELECT email, encrypted_password FROM users LIMIT 5;
  

  和旧服务器的数据库备份对比，确认哈希值是否有字符乱码或不一致的情况。
• 检查密码参数编码：
  在SessionsController#create方法中添加日志，确认传入密码的编码：

  def create
    logger.debug "Password encoding: #{params[:user][:password].encoding}"
    # 原有代码...
  end
  

  正常情况下应该是UTF-8编码，如果显示为latin2，说明参数被错误转码。
• 确认BCrypt版本兼容性：
  查看Gemfile中的bcrypt版本，Rails 4.1兼容的bcrypt版本最高为3.1.x，若版本过低，尝试升级到3.1.17（Rails 4.1支持的稳定版）：

  # Gemfile
  gem 'bcrypt', '~> 3.1.17'
  

  执行bundle update bcrypt更新。

解决方案 #

1. 修复字段编码（根本解决）

即使数据库级必须用latin2，也可以单独将users表的encrypted_password字段设置为UTF-8编码，避免哈希值被转码：

• 生成迁移文件：

  rails generate migration ChangeEncryptedPasswordCharset
  

  编辑生成的迁移文件内容：

  class ChangeEncryptedPasswordCharset < ActiveRecord::Migration
    def change
      change_column :users, :encrypted_password, :string, charset: 'utf8mb4', collation: 'utf8mb4_unicode_ci'
    end
  end
  

• 运行迁移：

  rake db:migrate
  

  该操作会让encrypted_password字段强制使用UTF-8存储，不受数据库级编码影响。

2. 恢复原始哈希值（针对已损坏数据）

如果有旧服务器的数据库备份，可将备份中users表的encrypted_password字段值导出（确保导出时用UTF-8编码，避免转码），然后覆盖新服务器的对应字段。

3. 临时应急方案（不推荐）

若上述方案暂时无法实施，可让用户重置密码（重置时会生成新的BCrypt哈希，存储到修复后的字段中），但这会影响用户体验。

验证修复 #

• 重启Rails应用后，测试登录功能，确认valid_password?能正确返回true。
• 测试密码更新功能，确认不再抛出BCrypt::Errors::InvalidHash错误。

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