使用RSpec+Capybara/Selenium批量运行系统测试时出现异常问题

我用Capybara/Selenium编写了常规的RSpec Rails系统测试，示例代码如下：

RSpec.describe "Model", type: :system do
  context "update model info1" do
    # ...
  end

  context "update model info2" do
    # ...
  end

  context "update model info3" do
    # ...
  end

  # ...
end

单独运行某个测试（如"update model info1"或"update model info2"上下文）时，所有测试均能成功通过，但从根层级（RSpec.describe "Model"）批量运行所有测试时，部分测试会失败。测试始终为顺序执行。

补充环境信息：MacOs Ventura 13.0系统，使用rails 7.0.4.3、rspec-rails 6.0.1、capybara 3.38.0和selenium-webdriver 4.8.1。

1. 测试间状态污染 #

这是最典型的问题：单独运行时每个测试都拥有干净的环境，但批量运行时，前一个测试留下的数据库数据、浏览器Session/Cookie会干扰后续测试。

解决措施：

• 隔离数据库状态：RSpec Rails默认的事务式Fixture在系统测试中可能失效（Capybara的浏览器进程无法共享事务），改用database_cleaner gem，配置为每个测试后清理数据库。
  示例配置（新建spec/support/database_cleaner.rb）：

  RSpec.configure do |config|
    config.before(:suite) do
      DatabaseCleaner.strategy = :transaction
      DatabaseCleaner.clean_with(:truncation)
    end
  
    config.before(:each, type: :system) do
      DatabaseCleaner.strategy = :truncation
    end
  
    config.before(:each) do
      DatabaseCleaner.start
    end
  
    config.after(:each) do
      DatabaseCleaner.clean
    end
  end
  

• 重置浏览器状态：在每个测试结束后清理Session和Cookie，可在RSpec配置中添加钩子：

  RSpec.configure do |config|
    config.after(:each, type: :system) do
      Capybara.reset_sessions!
      page.driver.quit # 可选，彻底关闭浏览器进程，避免残留
    end
  end
  

2. 测试依赖前置执行结果 #

部分测试隐含依赖前一个测试的执行产物（比如某个数据仅在第一个测试中创建），单独运行时手动满足了前置条件，但批量运行时顺序变化或前序测试未执行就会失败。

解决措施：

• 让每个测试自给自足：在测试内部或before(:each)块中创建所需的测试数据，不要依赖其他测试的执行。
  示例（结合FactoryBot）：

  context "update model info1" do
    let(:model) { create(:model) }
  
    before do
      visit edit_model_path(model)
    end
  
    it "updates info successfully" do
      # ...测试步骤
    end
  end
  

3. 异步操作等待不充分 #

批量运行时系统资源占用较高，部分AJAX请求、动画等异步操作的执行速度变慢，Capybara默认的等待时间可能不足以完成操作，导致断言失败。

解决措施：

• 显式等待关键元素：使用find方法配合wait参数，或使用带等待机制的匹配器，避免直接用无等待的判断。
  示例：

  expect(page).to have_selector('.success-message', wait: 10)
  

• 调整默认等待时间：在spec/support/capybara.rb中修改全局等待时长：

  Capybara.default_max_wait_time = 10 # 默认2秒，可根据实际情况调整
  

4. 浏览器进程残留 #

批量运行时，前一个测试的浏览器进程未完全关闭，导致后续测试的上下文混乱。

解决措施：

• 强制关闭浏览器进程：在after(:each)钩子中添加page.driver.quit，或改用无头浏览器（如headless Chrome），减少进程残留问题。
  无头Chrome配置示例：

  Capybara.register_driver :selenium_chrome_headless do |app|
    options = Selenium::WebDriver::Chrome::Options.new
    options.add_argument('--headless=new')
    options.add_argument('--disable-gpu')
    options.add_argument('--no-sandbox')
    Capybara::Selenium::Driver.new(app, browser: :chrome, options: options)
  end
  
  RSpec.configure do |config|
    config.before(:each, type: :system) do
      driven_by :selenium_chrome_headless
    end
  end
  

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