Rails 4.2升5.0+Devise 3升4：请求环境缺失Warden::Proxy实例

问题背景 #

正在将旧 Rails 4.2 应用升级至 Rails 5.0，同步把 Devise 从 3.x 版本升级到兼容 Rails 5 的 4.9.2 版本（依据文档及 railsbump.org 选择该版本）。bundle install 执行成功，服务器可正常启动，但访问任意页面都会触发 Devise 相关错误。

错误信息 #

Error during failsafe response: Devise could not find the `Warden::Proxy` instance on your request environment.
Make sure that your application is loading Devise and Warden as expected and that the `Warden::Manager` middleware is present in your middleware stack.
If you are seeing this on one of your tests, ensure that your tests are either executing the Rails middleware stack or that your tests are using the `Devise::Test::ControllerHelpers` module to inject the `request.env['warden']` object for you.
  /home/josh/.rbenv/versions/2.7.6/lib/ruby/gems/2.7.0/gems/devise-4.9.2/lib/devise/controllers/helpers.rb:143:in `warden'
  /home/josh/.rbenv/versions/2.7.6/lib/ruby/gems/2.7.0/gems/devise-4.9.2/lib/devise/controllers/helpers.rb:126:in `current_user'
  /home/josh/.rbenv/versions/2.7.6/lib/ruby/gems/2.7.0/gems/paper_trail-4.0.2/lib/paper_trail/frameworks/rails/controller.rb:19:in `user_for_paper_trail'
  /home/josh/.rbenv/versions/2.7.6/lib/ruby/gems/2.7.0/gems/paper_trail-4.0.2/lib/paper_trail/frameworks/rails/controller.rb:65:in `set_paper_trail_whodunnit'

问题分析 #

• 栈追踪显示，PaperTrail 的 user_for_paper_trail 方法调用了 Devise 的 current_user，但此时请求环境中找不到 Warden::Proxy 实例
• 临时注释 PaperTrail 相关代码后页面可正常加载，但该功能是应用必需的，不能长期禁用
• 已确认问题出现在生产/开发环境（非测试环境），且中间件栈中存在 Warden::Manager
• 应用使用了自定义异常应用（代码如下），但该类未继承 ApplicationController，注释相关代码也无法解决问题：

def call(env)
  status = env["PATH_INFO"][1..-1]

  if status == "404" || status == '422' || status == '500'
    Rails.application.routes.call(env)
  else
    super
  end
end

解决方案 #

1. 升级 PaperTrail 至兼容 Rails 5 的版本 #

PaperTrail 4.0.2 仅支持 Rails 4.0-4.2，与 Rails 5 + Devise 4.x 存在兼容问题。升级到支持 Rails 5 的版本（如 4.1.x 及以上）：

bundle update paper_trail

升级后，PaperTrail 的用户追踪逻辑会适配新的 Devise 和 Rails 环境，避免在未初始化 Warden 的场景下调用 current_user。

2. 安全覆盖 PaperTrail 的 user_for_paper_trail 方法 #

在 ApplicationController 中覆盖该方法，添加 Warden 存在性检查，避免在 failsafe 响应等特殊流程中报错：

class ApplicationController < ActionController::Base
  def user_for_paper_trail
    # 先验证 Warden 实例是否存在，再安全获取当前用户
    if request.env['warden'].present?
      current_user&.id
    else
      'system' # 可根据需求定义无有效用户时的默认值，比如空字符串
    end
  end
end

这种方式能确保即使在 Warden 未初始化的场景下，也不会触发 Devise 的错误。

3. 调整自定义异常应用的执行逻辑 #

原异常应用直接调用 Rails.application.routes.call(env) 会绕过部分中间件（包括 Warden），导致路由处理时缺少 Warden 环境。修改为通过控制器渲染错误页面，保留完整的中间件上下文：

class CustomExceptionApp
  def call(env)
    status = env["PATH_INFO"][1..-1]
    if %w[404 422 500].include?(status)
      # 用 ActionController 渲染错误模板，确保中间件栈正常执行
      controller = ActionController::Base.new
      controller.render(status: status, template: "errors/#{status}")
    else
      super
    end
  end
end

4. 确认 Warden 中间件的加载顺序 #

虽然 Devise 会自动添加 Warden 中间件，但升级后可能存在初始化顺序问题。可在 config/application.rb 中手动确保 Warden 中间件加载：

config.middleware.use Warden::Manager do |manager|
  manager.default_strategies :database_authenticatable
  manager.failure_app = Devise::FailureApp
end

添加后运行 rails middleware 确认 Warden::Manager 存在于中间件栈中。

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