Rails测试环境异常：路由与Fixture方法未定义

问题背景 #

运行Rails测试时，测试环境与应用完全断开连接：

• 取消setup中@lift = lifts(:one)注释时，提示undefined method 'lifts'（无法识别fixture）
• 注释该行后，提示undefined local variable or method 'lifts_url'（无法识别路由辅助方法）
• 相同代码在全新同配置应用中可正常运行，生产/开发环境应用本身运行正常

相关代码与配置 #

test_helper.rb #

ENV["RAILS_ENV"] ||= "test"
require_relative "../config/environment"
require "rails/test_help"

class ActiveSupport::TestCase
  include Devise::Test::IntegrationHelpers
  parallelize(workers: :number_of_processors)

  fixtures :all

end

LiftsController测试代码 #

require "test_helper"

class LiftsControllerTest < ActionDispatch::IntegrationTest

  setup do
#    @lift = lifts(:one)
    @admin = users(:admin)
    @one = users(:one)
  end

  test "should get index" do
    get lifts_url   # line 15
    assert_response :success
  end

路由配置（精简后） #

Rails.application.routes.draw do
  resources :lifts
end

rails routes输出（关键部分） #

% rails routes
                                  Prefix Verb   URI Pattern                                                                                       Controller#Action
                                   lifts GET    /lifts(.:format)                                                                                  lifts#index
                                         POST   /lifts(.:format)                                                                                  lifts#create
                                new_lift GET    /lifts/new(.:format)                                                                              lifts#new
                               edit_lift GET    /lifts/:id/edit(.:format)                                                                         lifts#edit
                                    lift GET    /lifts/:id(.:format)                                                                              lifts#show
                                         PATCH  /lifts/:id(.:format)                                                                              lifts#update
                                         PUT    /lifts/:id(.:format)                                                                              lifts#update
                                         DELETE /lifts/:id(.:format)                                                                              lifts#destroy

错误信息 #

错误1（启用fixture时） #

NoMethodError: undefined method `lifts' for #<LiftsControllerTest:0x000000010af1f738>
    /Users/deploy/.rbenv/versions/3.1.2/lib/ruby/gems/3.1.0/gems/actionpack-7.0.4/lib/action_dispatch/testing/assertions/routing.rb:187:in `method_missing'
    /Users/deploy/.rbenv/versions/3.1.2/lib/ruby/gems/3.1.0/gems/actionpack-7.0.4/lib/action_dispatch/testing/integration.rb:431:in `method_missing'

错误2（禁用fixture时） #

NameError: undefined local variable or method `lifts_url' for #<LiftsControllerTest:0x000000010aed1420>
    /Users/deploy/.rbenv/versions/3.1.2/lib/ruby/gems/3.1.0/gems/actionpack-7.0.4/lib/action_dispatch/testing/assertions/routing.rb:187:in `method_missing'
    /Users/deploy/.rbenv/versions/3.1.2/lib/ruby/gems/3.1.0/gems/actionpack-7.0.4/lib/action_dispatch/testing/integration.rb:431:in `method_missing'
    /Users/deploy/r/elevate/test/controllers/lifts_controller_test.rb:15:in `block in <class:LiftsControllerTest>'

底层代码指向 #

两个错误的堆栈均指向method_missing的super分支，说明测试环境无法正确加载路由或fixture的辅助方法：

routing.rb 第187行 #

# ROUTES TODO: These assertions should really work in an integration context
def method_missing(selector, *args, &block)
  if defined?(@controller) && @controller && defined?(@routes) && @routes && @routes.named_routes.route_defined?(selector)
    @controller.public_send(selector, *args, &block)
  else
    super
  end
end

integration.rb 第431行 #

# Delegate unhandled messages to the current session instance.
def method_missing(method, *args, &block)
  if integration_session.respond_to?(method)
    integration_session.public_send(method, *args, &block).tap do
      copy_session_variables!
    end
  else
    super
  end
end

修复方案 #

针对测试环境孤立的问题，按以下步骤排查修复：

• 清理测试环境缓存
  执行命令彻底清除测试环境的缓存文件：

  rails tmp:clear RAILS_ENV=test
  rails db:test:prepare
  

• 禁用并行测试排查
  临时注释test_helper.rb中的并行测试配置：

  # parallelize(workers: :number_of_processors)
  

  并行测试可能导致进程间资源加载异常，禁用后重新运行测试，若恢复正常则需调整并行测试的配置（如添加parallelize_setup确保fixture和路由正确加载）。

• 确认fixture文件存在且命名正确
  检查test/fixtures/lifts.yml是否存在，且文件名与模型名（Lift）的复数形式一致，内容格式符合YAML规范。

• 强制加载路由辅助方法
  在测试类中手动引入路由辅助模块，确保测试环境能正确识别路由方法：

  class LiftsControllerTest < ActionDispatch::IntegrationTest
    include Rails.application.routes.url_helpers
  
    # ... 其余测试代码
  

• 排查Gem依赖冲突
  对比全新应用的Gemfile.lock，检查当前项目中是否存在干扰测试环境的Gem（如某些测试工具、缓存类Gem），尝试临时移除可疑Gem后重新运行测试。

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