FactoryBot跨测试调用工厂报错：Factory未注册

一、解决KeyError: Factory not registered错误 #

检查工厂文件结构与命名 #

FactoryBot默认自动加载spec/factories目录下的所有.rb文件，每个工厂文件需严格对应模型命名：

• 用户模型对应spec/factories/user.rb或users.rb
• 作品模型对应spec/factories/production.rb或productions.rb
  同时确保工厂定义的符号与调用一致，比如模型是Production，工厂名要写:production（单数）：

# spec/factories/production.rb
FactoryBot.define do
  factory :production do
    name { "Cars" }
    # 其他必填属性
  end
end

确认Rails Helper的FactoryBot配置 #

打开spec/rails_helper.rb，检查是否包含以下关键配置：

# 引入factory_bot_rails依赖
require 'factory_bot_rails'

RSpec.configure do |config|
  # 启用FactoryBot语法糖（直接用create、build方法）
  config.include FactoryBot::Syntax::Methods

  # 优化数据清理：用事务替代手动截断（效率更高）
  config.use_transactional_fixtures = true

  # 若坚持用DatabaseCleaner，替换你当前的after(:each)配置
  config.before(:suite) do
    DatabaseCleaner.strategy = :transaction
    DatabaseCleaner.clean_with(:truncation)
  end

  config.around(:each) do |example|
    DatabaseCleaner.cleaning do
      example.run
    end
  end
end

注意：你当前手动调用DatabaseCleaner.clean_with(:truncation)会导致每次测试全表截断，效率极低，建议改用事务清理策略。

排查工厂定义拼写错误 #

检查工厂文件里的符号拼写，比如不要把:user写成:users，确保调用的工厂名和定义完全一致。

二、Token验证测试优化方案 #

1. 复用测试逻辑：用Shared Examples抽通用场景 #

把token验证的重复测试抽成共享示例，避免代码冗余：

# spec/support/shared_examples/authentication.rb
RSpec.shared_examples "requires valid auth" do |method, path|
  context "无token时" do
    it "返回未授权状态" do
      send(method, path, headers: {})
      expect(response).to have_http_status(:unauthorized)
    end
  end

  context "token格式错误时" do
    it "返回未授权状态" do
      send(method, path, headers: { "Authorization" => "WrongFormat 123" })
      expect(response).to have_http_status(:unauthorized)
    end
  end

  context "token无效时" do
    it "返回未授权状态" do
      send(method, path, headers: { "Authorization" => "Token token=invalid_123" })
      expect(response).to have_http_status(:unauthorized)
    end
  end
end

在测试文件中引入并复用：

# characters_spec.rb顶部
require 'support/shared_examples/authentication'

describe "GET characters" do
  it_behaves_like "requires valid auth", :get, '/api/v1/characters'
  # 其他测试逻辑...
end

describe "GET /characters/:id" do
  it_behaves_like "requires valid auth", :get, "/api/v1/characters/#{ch1.id}"
  # 其他测试逻辑...
end

2. 简化Header生成：封装辅助方法 #

在spec/support/request_helpers.rb中定义生成请求头的方法：

module RequestHelpers
  def valid_auth_headers(user)
    token = AuthTokenService.call(user.id)
    { "Authorization" => "Token token=#{token}" }
  end

  def invalid_auth_headers(user)
    token = AuthTokenService.call(user.id)
    { "Authorization" => "Token token=#{token}ASDF" }
  end
end

在rails_helper.rb中全局引入：

RSpec.configure do |config|
  config.include RequestHelpers, type: :request
end

之后在测试中直接调用：

let!(:user) { create(:user) }
let!(:valid_headers) { valid_auth_headers(user) }
let!(:invalid_headers) { invalid_auth_headers(user) }

3. 优化测试数据：用let!替代实例变量 #

RSpec的let!会在测试前预加载数据，比实例变量更清晰，且支持隔离性：

RSpec.describe "Characters", type: :request do
  let!(:user) { create(:user) }
  let!(:production) { create(:production) }
  let!(:valid_headers) { valid_auth_headers(user) }
  let!(:ch1) { create(:character) }
  let!(:ch2) { create(:character) }

  # 测试逻辑...
end

4. 覆盖更多验证场景 #

除当前的无效token，建议补充测试：

• 已过期的token（若你的token有过期机制）
• 对应已删除用户的token
• 签名错误的token

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