Devise：已停用用户登录时引导至账号重新激活页面方案

哈哈，这个需求我之前帮朋友实现过，其实核心就是重写Devise的Sessions控制器，结合你已经实现的软删除逻辑来做判断。我给你一步步拆解，保证你能搞定：

1. 先确认User模型的软删除与认证状态逻辑 #

首先要确保你的User模型里已经正确重写了Devise的认证状态方法，这样系统才能识别出“已停用”的用户：

# app/models/user.rb
class User < ApplicationRecord
  devise :database_authenticatable, :registerable,
         :recoverable, :rememberable, :validatable

  # 软删除方法（你应该已经实现了这个）
  def soft_delete
    update(deleted_at: Time.current) # 假设你的软删除字段是deleted_at，根据自己的字段调整
  end

  # Devise核心方法：判断用户是否可登录
  def active_for_authentication?
    super && !deleted_at.present? # 只有未被软删除的用户才能正常登录
  end

  # 自定义认证失败时的提示消息
  def inactive_message
    deleted_at.present? ? :deleted_account : super
  end
end

2. 生成自定义的Sessions控制器 #

Devise默认的控制器是封装好的，我们需要生成自己的控制器来修改登录逻辑：

rails generate devise:controllers users -c sessions

这条命令会在app/controllers/users目录下生成sessions_controller.rb，专门处理用户登录相关的逻辑。

3. 配置路由，让Devise使用自定义控制器 #

修改config/routes.rb，把Devise的session路由指向我们刚生成的控制器，同时添加重新激活页面的路由：

# config/routes.rb
devise_for :users, controllers: { sessions: 'users/sessions' }

# 新增重新激活页面的路由
get 'users/reactivate', to: 'users/sessions#reactivate'
post 'users/reactivate', to: 'users/sessions#restore'

4. 重写Sessions控制器的登录逻辑 #

打开生成的users/sessions_controller.rb，重写create方法，捕获软删除用户的登录请求，并跳转到重新激活页面：

# app/controllers/users/sessions_controller.rb
class Users::SessionsController < Devise::SessionsController
  # 重写登录动作，处理软删除用户的情况
  def create
    # 尝试正常登录
    self.resource = warden.authenticate!(auth_options)
    set_flash_message!(:notice, :signed_in)
    sign_in(resource_name, resource)
    yield resource if block_given?
    respond_with resource, location: after_sign_in_path_for(resource)
  rescue Warden::AuthenticationError => e
    # 判断错误是否来自已停用的账户
    if e.message == I18n.t('devise.failure.deleted_account')
      # 根据登录时输入的邮箱找到对应的用户
      user = User.find_by(email: params[:user][:email])
      if user&.deleted_at.present?
        # 跳转到重新激活页面，传递用户邮箱用于后续激活
        redirect_to users_reactivate_path(email: user.email), 
                    alert: "你的账户已停用，请重新激活后登录。"
      else
        # 其他认证错误，走Devise默认逻辑
        super
      end
    else
      super
    end
  end

  # 显示重新激活页面
  def reactivate
    @email = params[:email]
    # 如果没有传递邮箱，也可以在这里做让用户输入邮箱的逻辑，根据需求调整
  end

  # 处理账户重新激活的逻辑
  def restore
    user = User.find_by(email: params[:email])
    if user&.deleted_at.present?
      # 清除软删除标记，恢复账户
      user.update(deleted_at: nil)
      # 自动登录已激活的用户
      sign_in(user)
      redirect_to root_path, notice: "账户已成功激活！欢迎回来～"
    else
      redirect_to new_user_session_path, alert: "无效的激活请求，请检查后重试。"
    end
  end
end

5. 创建重新激活页面的视图 #

在app/views/users/sessions目录下新建reactivate.html.erb，制作激活页面：

<h1>账户重新激活</h1>
<p>你的账户已被暂时停用，点击下方按钮即可重新激活：</p>

<%= form_tag users_reactivate_path, method: :post do %>
  <%= hidden_field_tag :email, @email %>
  <%= submit_tag "重新激活我的账户", class: "btn btn-primary" %>
<% end %>

<p>如果这不是你的操作，请联系客服处理。</p>

6. 添加国际化提示消息（可选但推荐） #

在config/locales/devise.en.yml里添加自定义的错误提示，让消息更友好：

en:
  devise:
    failure:
      deleted_account: "你的账户已停用，请重新激活后登录。"

关键逻辑说明 #

• active_for_authentication?：这是Devise认证流程中会调用的核心方法，我们在这里加入了软删除的判断，确保只有未被删除的用户能正常登录。
• 捕获Warden::AuthenticationError：当用户因软删除无法登录时，Devise会抛出这个错误，我们通过错误消息判断是否是账户停用的情况，进而跳转至激活页面。
• 激活逻辑：通过restore方法清除用户的软删除标记，然后自动登录用户，提升体验。

你可以根据自己的实际情况调整字段（比如有的项目用is_deleted布尔字段，那把!deleted_at.present?改成!is_deleted即可），视图样式也可以按照项目风格修改。

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