RSpec系统测试因JavaScript未执行完成失败，求解决方案

1. 调整无头Chrome启动参数 #

无头模式的默认配置和普通Chrome有差异，比如窗口尺寸、性能限制，试试给无头Chrome加这些启动参数优化：

Capybara.register_driver :headless_chrome do |app|
  options = Selenium::WebDriver::Chrome::Options.new.tap do |opts|
    opts.add_argument('--window-size=1920,1080') # 模拟桌面窗口，避免响应式布局干扰
    opts.add_argument('--disable-gpu') # 无头模式无需GPU，直接禁用
    opts.add_argument('--no-sandbox') # 解决部分环境的权限问题
    opts.add_argument('--disable-dev-shm-usage') # 避免共享内存不足导致卡顿
    opts.add_argument('--disable-extensions') # 禁用扩展，减少不必要干扰
    opts.add_argument('--disable-popup-blocking') # 允许弹窗，防止模态框被拦截
    opts.add_preference('dom.max_script_run_time', 60) # 延长JS执行超时时间
  end
  Capybara::Selenium::Driver.new(app, browser: :chrome, options: options)
end

然后在spec/rails_helper.rb或spec/spec_helper.rb里配置驱动：

driven_by :headless_chrome

2. 用Capybara智能等待替代硬编码sleep #

别用sleep 1这种碰运气的方式，Capybara自带智能等待机制，会自动等元素出现或JS执行完成：

• 等元素可见：expect(page).to have_selector('.feedback-message', visible: true, wait: 5)
• 等文本出现：expect(page).to have_content('用户创建成功', wait: 5)
• 等模态框加载：expect(page).to have_css('#modal', visible: true, wait: 5)
  还可以全局调大默认等待时间（默认2秒）：

Capybara.default_max_wait_time = 5

3. 清理测试间的状态污染 #

批量跑测试时，前一个测试的浏览器状态（cookie、localStorage）或数据库数据可能残留，影响后续测试的JS行为：

• 用database_cleaner确保每个测试前后数据库重置
• 在系统测试的after(:each)里关闭浏览器会话，避免状态残留：

after(:each) do
  Capybara.current_session.driver.quit
end

或者直接重置会话：

Capybara.reset_sessions!

4. 确保Chrome与chromedriver版本匹配 #

就算用了最新的selenium-webdriver，也要保证Chrome浏览器和chromedriver版本完全一致。用webdrivers gem可以自动管理版本：

# Gemfile里添加
gem 'webdrivers', group: :test

跑bundle install后，它会自动下载和当前Chrome匹配的chromedriver，避免版本不兼容导致的JS执行异常。

5. 开启Chrome日志排查问题 #

如果前面的方法都没用，开启Chrome的浏览器日志，看看JS执行时有没有报错：

# 在驱动配置里加日志参数
options.add_argument('--enable-logging')
options.add_argument('--v=1') # 开启详细日志

# 测试失败时输出日志
driver = Capybara::Selenium::Driver.new(app, browser: :chrome, options: options)
driver.browser.manage.logs.get(:browser).each do |log|
  puts "[Chrome Log] #{log.level}: #{log.message}"
end

通过日志能定位到具体的JS错误、资源加载失败等问题，方便精准修复。

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