Rails测试配置引发Warden的UncaughtThrowError问题

我之前也碰到过类似的问题，咱们一步步拆解排查：

首先得明确一个关键点：Devise integration_helpers.rb里的Warden配置是针对集成测试/系统测试的，如果你写的是控制器单元测试，直接用这些配置可能会因为钩子没加载全而出错。

1. 先给测试环境补全Warden基础配置 #

不管你写的是哪种测试，先在test_helper.rb里加上这段，确保Warden在测试模式下运行，并且每次测试后重置状态：

Warden.test_mode!

class ActiveSupport::TestCase
  teardown do
    Warden.test_reset!
  end
end

这能避免测试之间的状态污染，很多Warden异常都是因为之前的测试残留了认证状态导致的。

2. 针对单元测试的正确写法（以控制器测试为例） #

如果是测SessionsController的登录逻辑，别直接用Devise的集成方法，手动模拟请求并检查Warden状态：

test "unconfirmed user should be blocked from login" do
  # 明确创建未确认的用户，别让工厂默认给confirmed_at赋值
  user = User.create(email: "test@example.com", password: "password123", confirmed_at: nil)

  # 模拟登录请求
  post login_path, params: { user: { email: user.email, password: user.password } }

  # 验证重定向逻辑
  assert_redirected_to login_path
  # 验证提示消息是否正确
  assert_equal I18n.t("devise.failure.unconfirmed"), flash[:alert]
  # 确认用户确实没被登录
  assert_not warden.authenticated?(:user)
end

3. 解决UncaughtThrowError的核心 #

你碰到的UncaughtThrowError，本质是Warden认证失败时抛出了:warden符号，但测试环境没捕获到。如果是写系统测试（集成测试），可以直接用Devise的路由和标准请求写法：

test "unconfirmed user gets redirected with unconfirmed alert" do
  user = User.create!(email: "unconfirmed@test.com", password: "securepass", confirmed_at: nil)

  post user_session_path, params: { user: { email: user.email, password: user.password } }

  assert_redirected_to new_user_session_path
  assert_equal I18n.t("devise.failure.unconfirmed"), flash[:alert]
  # 用自定义的登录检查方法确认未登录
  assert_not is_logged_in?
end

4. 排查基础配置是否到位 #

别漏了检查这两处：

• 确保config/initializers/devise.rb里开启了确认模块：config.confirmable = true
• 确保用户模型里包含:confirmable：

class User < ApplicationRecord
  devise :database_authenticatable, :registerable,
         :recoverable, :rememberable, :validatable, :confirmable
end

5. 确保用户确实是未确认状态 #

有时候工厂或者测试数据会偷偷给用户设置confirmed_at，一定要明确指定confirmed_at: nil，或者给工厂加个trait：

FactoryBot.define do
  factory :user do
    # ... 其他属性
    trait :unconfirmed do
      confirmed_at { nil }
    end
  end
end

测试时用create(:user, :unconfirmed)就能确保用户是未确认状态了。

内容的提问来源于stack exchange，提问作者Heather V.