设置RAILS_ENV为test运行RSpec时Bundle.require报NameError

安全阿岳

2026-8-26

排查方向

初始数据库清空问题的推测是准确的：未显式设置RAILS_ENV时，Rails启动会默认fallback到development环境，DatabaseCleaner会直接连接开发库执行清理操作，可在无配置场景下打印Rails.env直接验证。
常量报错本质是加载顺序/自动加载问题：NameError: uninitialized constant FactoryBotFactory::BaseFactory说明显式设置RAILS_ENV=test后，要么是Bundler加载test组gem的顺序发生变化，自定义的FactoryBot封装类在FactoryBot原生依赖未加载完成时就被提前加载；要么是test环境的预加载(eager_load)策略和development环境不同，自定义类的路径不符合Rails自动加载规范，提前触发常量查找时找不到对应定义。
检查全局常量加载时机：当前逻辑是在Bundler执行依赖加载后立刻加载全局常量，如果常量文件中存在对FactoryBot等仅在test组存在的gem的引用，在test环境初始化阶段就会提前触发相关常量解析，而此时框架的自动加载流程还没完成，就会抛出错误。

解决方案

首先修正rails_helper.rb的标准配置，从入口确保测试运行在test环境，避免污染开发库：

require 'spec_helper'
ENV['RAILS_ENV'] ||= 'test'
require File.expand_path('../config/environment', __dir__)
# 增加环境校验，避免意外跑在其他环境
abort("Rails environment is running in #{Rails.env} mode, expected test!") unless Rails.env.test?

调整application.rb中的加载顺序，把依赖测试gem的自定义常量加载放到框架初始化完成后，避免提前触发常量解析：

Bundler.require(*Rails.groups)
Dotenv::Railtie.load unless Rails.env.production?

module MyApp
  class Application < Rails::Application
    # 原有配置项保留
    # 把lib目录加入自动加载路径，确保自定义类可以被正常找到
    config.autoload_paths << Rails.root.join('lib')

    config.after_initialize do
      # 等所有gem、框架初始化完成后，再加载全局常量
      require_relative 'constants' unless Rails.env.production?
    end
  end
end

校验Gemfile配置，确保factory_bot_rails正确放在test分组下，避免跨环境加载异常：

group :test do
  gem 'factory_bot_rails'
  # 其余测试依赖gem
end

校验自定义FactoryBot封装类的命名与路径匹配性：例如FactoryBotFactory::BaseFactory对应的文件路径应为lib/factory_bot_factory/base_factory.rb，符合Rails自动加载的命名规范，否则会出现常量找不到的问题。
修复完成后先做两步验证：第一执行RAILS_ENV=test rails c进入控制台，输入FactoryBot和FactoryBotFactory::BaseFactory确认常量可正常解析；第二运行RSpec，查看数据库连接日志确认连接的是test数据库，不会清空开发库数据。

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