RoR项目使用Devise和Rails Admin时管理员如何登录其他普通用户账号

方案一：原生Devise + Rails Admin自定义操作（无额外Gem依赖） #

无需引入第三方包，直接基于Devise自带的登录登出方法实现，可控性最高：

• 第一步：在Rails Admin配置中添加用户切换的自定义动作，路径为config/initializers/rails_admin.rb

RailsAdmin.config do |config|
  config.actions do
    # 保留原有配置，新增下方自定义动作
    member :switch_user do
      only ['User']
      i18n_key :switch_user
      link_icon 'fas fa-user-switch'
      controller do
        proc do
          # 严格权限校验：仅管理员可执行操作
          if current_user.admin?
            # 记录当前管理员ID到Session，后续可切回
            session[:admin_sudo_id] = current_user.id
            # 登出管理员，登录目标普通用户
            sign_out current_user
            sign_in @object
            flash[:notice] = "已切换到用户 #{@object.name} 的账号"
            redirect_to root_path
          else
            flash[:alert] = "无权限执行此操作"
            redirect_to rails_admin.dashboard_path
          end
        end
      end
    end
  end
end

• 第二步：添加切回管理员账号的逻辑，在app/controllers/application_controller.rb中新增全局校验和切回方法

class ApplicationController < ActionController::Base
  before_action :check_sudo_mode

  # 全局判断当前是否处于管理员模拟用户状态
  def check_sudo_mode
    if session[:admin_sudo_id].present? && User.find_by(id: session[:admin_sudo_id])&.admin?
      @is_sudo = true
    end
  end

  # 切回管理员账号的动作
  def switch_back_admin
    if session[:admin_sudo_id].present?
      admin = User.find(session[:admin_sudo_id])
      sign_out current_user
      sign_in admin
      session.delete(:admin_sudo_id)
      flash[:notice] = "已切回管理员账号"
      redirect_to rails_admin.dashboard_path
    else
      flash[:alert] = "当前不在账号模拟状态"
      redirect_to root_path
    end
  end
end

• 第三步：在config/routes.rb中添加切回动作的路由，然后在前端导航栏添加判断：如果@is_sudo为true，显示「切回管理员」按钮即可，入口仅管理员模拟时可见，不影响普通用户使用

get '/switch_back_admin', to: 'application#switch_back_admin'

方案二：使用devise_masquerade Gem（成熟封装方案） #

Devise生态内的成熟用户切换工具，已经内置安全校验、操作日志等能力，集成成本更低：

• 第一步：在Gemfile中添加依赖后执行bundle install

gem 'devise_masquerade'

• 第二步：给User模型添加对应模块

class User < ApplicationRecord
  devise :database_authenticatable, :registerable,
         :recoverable, :rememberable, :validatable,
         :masqueradable # 新增该行即可
end

• 第三步：在Rails Admin配置中添加切换入口，直接调用Gem内置的路由即可

RailsAdmin.config do |config|
  config.actions do
    member :switch_user do
      only ['User']
      controller do
        proc do
          redirect_to main_app.masquerade_path(@object)
        end
      end
    end
  end
end

Gem默认提供/back_masquerade切回路由，直接在前端添加入口即可，还支持自定义操作日志、有效期等配置。 #

注意事项 #

• 所有切换操作必须做严格的权限校验，仅管理员角色可访问
• 建议新增操作日志表，记录哪个管理员在什么时间切换到了哪个用户，留审计痕迹
• 模拟用户状态下的业务操作，建议在日志中额外标记为管理员模拟操作，避免和用户本人操作混淆
• 禁止使用修改普通用户密码的方式实现该需求，会影响存量用户正常登录，存在严重安全隐患

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