Rails 5.1系统测试间歇性失败：测试互相干扰引发ActiveRecordNotFound错误

我之前帮朋友排查过一模一样的问题——Rails 5.1的系统测试单独跑全过，批量跑就炸出ActiveRecordNotFound，核心原因就是数据库清理的时机没跟上测试启动的速度。下面给你拆解解决方案：

一、先检查测试相关Gem配置 #

确保你的Gemfile测试组包含这些必要依赖，尤其是数据库清理和系统测试驱动：

group :test do
  gem 'capybara'               # 系统测试必备的页面交互库
  gem 'database_cleaner-active_record'  # 精准控制数据库清理
  gem 'rails-controller-testing'        # 兼容Rails 5+的控制器测试
  gem 'selenium-webdriver'    # 系统测试的浏览器驱动（Chrome/Firefox）
end

执行bundle install确保依赖都装好。

二、调整RailsHelper.rb的测试配置 #

Rails 5.1默认的事务测试机制在系统测试场景下会失效（因为Capybara跑在独立线程），所以要替换成database_cleaner的策略，确保每个测试前后数据库都被彻底清理：

# Rails_helper.rb
require 'database_cleaner'

RSpec.configure do |config|
  # 禁用Rails默认的事务式测试（系统测试不适用）
  config.use_transactional_fixtures = false

  # 测试套件启动前，一次性清空数据库
  config.before(:suite) do
    DatabaseCleaner.clean_with(:truncation)
  end

  # 普通测试用事务策略（速度快）
  config.before(:each) do
    DatabaseCleaner.strategy = :transaction
  end

  # 系统测试强制用truncation策略（跨线程生效）
  config.before(:each, type: :system) do
    DatabaseCleaner.strategy = :truncation
    # 配置无头Chrome驱动（可选，适合CI环境）
    driven_by :selenium_chrome_headless
  end

  # 每个测试开始前启动清理
  config.before(:each) do
    DatabaseCleaner.start
  end

  # 每个测试结束后彻底清理数据库
  config.append_after(:each) do
    DatabaseCleaner.clean
  end
end

重点：系统测试必须用:truncation或:deletion策略，因为事务无法跨浏览器线程共享，批量运行时上一个测试的残留数据会干扰下一个测试。

三、典型报错示例 #

你遇到的错误应该类似这样：

Failure/Error: visit post_path(@post)

ActiveRecord::RecordNotFound:
  Couldn't find Post with 'id'=456
# ./app/controllers/posts_controller.rb:18:in `show'
# ./spec/system/posts/view_post_spec.rb:10:in `block (2 levels) in <top (required)>'

本质是：批量运行时，上一个测试的数据库清理操作还没完成，下一个测试已经尝试访问被清理掉的记录，或者测试之间意外共享了数据。

额外注意事项 #

• 确保每个测试都是完全独立的：不要在测试外全局创建数据，每个测试用fixture或factory_bot生成自己需要的测试数据。
• 如果用FactoryBot，避免使用FactoryBot.create_list这类全局数据生成方法，尽量在每个测试块内创建。

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