Ruby自动化测试在CircleCI及本地批量运行时随机失败求助

从你描述的随机失败现象和测试代码来看，这类问题大多和异步操作未充分等待、测试环境资源竞争或者iframe交互时序问题有关，下面是针对性的解决方案和调试思路：

一、核心问题：异步操作与DOM更新的等待缺失 #

你的测试涉及了ACH交易创建（大概率是异步请求）和iframe支付流程，这两个场景很容易出现“元素已渲染但数据未更新”的时序问题，也是随机失败的核心诱因。

1. 升级Ajax等待逻辑 #

你现有的WaitForAjax只检查了jQuery.active，但如果页面使用了Fetch API、原生XHR等其他异步方案，这个判断就会失效。可以扩展等待逻辑覆盖更多场景：

module WaitForAjax
  def wait_for_ajax
    Timeout.timeout(Capybara.default_max_wait_time + 5) do
      loop until finished_all_ajax_requests?
    end
  end

  def finished_all_ajax_requests?
    page.evaluate_script <<~JS
      // 同时检查jQuery、页面加载状态和原生请求
      (typeof jQuery !== 'undefined' ? jQuery.active === 0 : true) &&
      document.readyState === 'complete' &&
      (window.pendingRequests === undefined || window.pendingRequests === 0)
    JS
  end
end

并且在创建交易后强制等待异步完成，不要依赖Capybara的自动等待（自动等待只检查元素是否存在，不关心数据是否更新）：

create_ach_transaction('today_amount': 100, 'total_amount': 500, 'patient_id': patient_id, 'payments_number': 2)
wait_for_ajax
# 针对CircleCI的慢环境，可增加短时间的稳定等待（尽量用显式等待替代sleep）
sleep 1

2. 优化iframe交互的等待逻辑 #

支付流程在iframe内完成，切换iframe和返回主页面时都需要确保页面完全加载：

# 假设你有切换iframe的操作，先确保iframe加载完成
within_frame(find('iframe[src*="epay"]', wait: 10)) do
  # 填写表单、提交操作...
  # 等待iframe内的异步请求完成
  wait_for_ajax
end
# 返回主页面后，再次等待主页面的DOM更新
wait_for_ajax
# 用have_css的显式等待替代find，Capybara会自动重试直到超时
expect(page).to have_css(Patients::FIRST_PATIENT_BALANCE, text: '$500.00', wait: 10)

注意：have_css的wait参数比直接page.find更可靠，因为它会持续检查元素文本是否符合预期，而不是找到元素就立即断言。

二、CircleCI环境稳定性优化 #

CircleCI的无头Chrome环境资源有限，容易出现渲染延迟，这些配置调整能减少随机失败：

1. 调整Chrome驱动参数 #

修改headless_chrome的配置，增加针对CI环境的稳定参数：

Capybara.register_driver :headless_chrome do |app|
  capabilities = Selenium::WebDriver::Remote::Capabilities.chrome(
    chromeOptions: { 
      args: %w[
        headless 
        disable-gpu 
        no-sandbox 
        disable-dev-shm-usage 
        window-size=1920,1080 # 固定窗口大小，避免响应式布局干扰
        disable-extensions
        --enable-features=NetworkService,NetworkServiceInProcess
      ]
    }
  )
  Capybara::Selenium::Driver.new app, browser: :chrome, desired_capabilities: capabilities
end

• no-sandbox和disable-dev-shm-usage解决CircleCI的容器资源限制问题
• 固定窗口大小避免响应式布局导致元素定位或渲染异常

2. 增强测试隔离性 #

随机失败可能是测试间的状态污染，确保每个测试都有干净的环境：

RSpec.configure do |config|
  config.before(:each) do
    # 用DatabaseCleaner清理数据库（如果未使用）
    DatabaseCleaner.strategy = :transaction
    DatabaseCleaner.start
    # 重置Capybara会话，避免跨测试的状态残留
    Capybara.reset_sessions!
  end

  config.after(:each) do
    DatabaseCleaner.clean
  end

  # 给失败的测试增加重试机制
  config.example_status_persistence_file_path = 'spec/examples.txt'
  config.around(:each) do |example|
    example.run_with_retry retry: 2
  end
end

三、调试技巧：定位随机失败的根源 #

1. 保存失败时的页面状态 #

在测试失败时自动保存截图和HTML，方便事后排查：

RSpec.configure do |config|
  config.after(:each) do |example|
    next unless example.exception

    Dir.mkdir('tmp/screenshots') unless Dir.exist?('tmp/screenshots')
    Dir.mkdir('tmp/pages') unless Dir.exist?('tmp/pages')
    
    screenshot_path = "tmp/screenshots/#{example.full_description.tr(' ', '_')}.png"
    page.save_screenshot(screenshot_path)
    
    page_path = "tmp/pages/#{example.full_description.tr(' ', '_')}.html"
    page.save_page(page_path)
  end
end

在CircleCI上可以把tmp/screenshots和tmp/pages配置为artifacts，失败后就能查看当时的页面状态。

2. 开启Chrome日志记录 #

在无头Chrome配置里开启日志，查看是否有JS错误或网络请求失败：

Capybara.register_driver :headless_chrome do |app|
  capabilities = Selenium::WebDriver::Remote::Capabilities.chrome(
    chromeOptions: { 
      args: [...],
      perfLoggingPrefs: { enableNetwork: true, enablePage: true }
    },
    loggingPrefs: { browser: 'ALL', performance: 'ALL' }
  )
  driver = Capybara::Selenium::Driver.new app, browser: :chrome, desired_capabilities: capabilities
  
  # 打印Chrome日志到控制台
  driver.browser.manage.logs.get(:browser).each do |log|
    puts "[Chrome Log] #{log.level}: #{log.message}"
  end
  driver
end

通过日志可以排查iframe加载失败、请求超时、JS报错等隐性问题。

3. 本地模拟CircleCI环境 #

用CircleCI CLI在本地模拟线上环境，复现随机失败：

# 安装CircleCI CLI
curl -fLSs https://circle.ci/cli | bash
# 在项目目录运行测试job
circleci local execute --job test

这样能快速排查环境差异导致的问题。

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