Rails 7中Devise用户隔段时间无法用有效凭据登录问题

针对「用户重置密码后可正常登录，过段时间又提示Invalid Email or password，控制台执行u.valid_password?('USER_PASSWORD')返回false」的问题，排查方向和解决方案如下：

1. 排查encrypted_password字段是否被意外篡改 #

重置密码后哈希值正常，后续失效大概率是该字段被非预期修改：

• 搜索项目中所有包含encrypted_password=的代码，排查后台任务、批量更新脚本或第三方插件是否有误操作
• 记录用户重置密码后的encrypted_password值，后续对比是否发生变化
• 检查数据库层面的手动操作、同步任务是否覆盖了该字段

修复：

• 移除或修正篡改字段的代码/任务
• 所有密码更新必须通过Devise提供的reset_password或update_with_password方法，禁止直接赋值encrypted_password

2. 检查bcrypt版本与兼容性 #

• 执行bundle show bcrypt确认版本，确保是~>3.0系列，避免被其他依赖强制变更版本
• 查看config/initializers/devise.rb，确认密码加密配置为config.password_hasher = :bcrypt
• 排查是否启用了Active Record加密，若误将encrypted_password加入加密字段，会导致bcrypt无法正常验证

修复：

• 在Gemfile中锁定版本：gem 'bcrypt', '~>3.0.0'，执行bundle update bcrypt
• 若启用Active Record加密，在用户模型中排除该字段：

  class User < ApplicationRecord
    encrypts :email # 仅加密需要的字段，排除encrypted_password
  end
  

3. 排查自定义密码验证逻辑 #

若项目重写了Devise的valid_password?方法或自定义验证逻辑，可能存在bug：

• 检查用户模型中是否有重写valid_password?的代码
• 查看Devise初始化文件是否有自定义验证配置

修复：

• 移除错误的自定义逻辑，恢复Devise默认验证
• 若需自定义，必须保留父类方法调用：

  def valid_password?(password)
    # 你的自定义逻辑（如额外校验）
    super(password) # 必须调用Devise原生验证
  end
  

4. 检查数据库字段长度 #

bcrypt生成的哈希值约60字符，若encrypted_password字段长度不足，会导致哈希值被截断：

• 查看数据库字段长度（MySQL需至少VARCHAR(60)，推荐VARCHAR(255)；PostgreSQL用TEXT或VARCHAR(255)）
• 检查用户的encrypted_password值长度，若小于60则说明被截断

修复：

• 生成迁移修改字段长度：

  class UpdateEncryptedPasswordLength < ActiveRecord::Migration[7.0]
    def change
      change_column :users, :encrypted_password, :string, limit: 255
    end
  end
  

• 执行rails db:migrate更新数据库

内容的提问来源于stack exchange，提问作者Mr.Muhammad Ramzan