Rspec运行自定义spec/features文件夹时出现DatabaseCleaner未初始化错误

出现这个错误的核心原因是运行rspec spec/features时，DatabaseCleaner常量未被正确加载，而rspec spec/能正常运行，通常是因为其他目录的测试文件触发了必要的加载逻辑。以下是具体排查方向和解决方法：

1. 检查feature测试文件的spec_helper引入 #

如果spec/features下的测试文件开头没有添加require 'spec_helper'，单独运行该目录测试时，RSpec可能不会自动加载spec_helper.rb（或加载时机滞后），导致before(:suite)钩子执行时DatabaseCleaner还未被初始化。

• 解决：
  • 给所有spec/features下的测试文件开头加上require 'spec_helper'；
  • 或者在项目根目录的.rspec文件中添加--require spec_helper，让RSpec自动加载spec_helper，无需每个文件手动引入。

2. 确认DatabaseCleaner gem的安装和分组 #

检查你的Gemfile，确保database_cleaner-active_record（或database_cleaner）被放在:test分组内：

group :test do
  gem 'database_cleaner-active_record'
  gem 'rspec-rails'
  # 其他测试依赖
end

执行bundle install确保gem被正确安装。如果gem不在:test分组，或者未安装，单独运行测试时可能无法加载该依赖。

3. 检查spec_helper.rb中的显式require #

即使Gemfile里有这个gem，也需要在spec/spec_helper.rb中手动引入DatabaseCleaner：

# spec/spec_helper.rb
require 'database_cleaner'

RSpec.configure do |config|
  config.before(:suite) do
    DatabaseCleaner[:active_record].strategy = :transaction
    # 其他数据库清理逻辑
  end
end

如果缺少这个require，运行rspec spec/时可能通过其他测试文件的间接依赖加载了它，但单独运行features测试时没有触发这个加载路径，导致报错。

4. 排查RSpec配置的条件限制 #

检查spec_helper.rb中DatabaseCleaner的配置代码是否被放在了某个条件块内（比如仅针对特定测试类型），如果条件不满足，会导致配置执行时DatabaseCleaner未被加载。确保配置是全局生效的，没有被不必要的条件限制。

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