Rails 4.2/Rspec 3.5/Capybara WebKit：自定义UA测试防泄漏

我之前也碰到过这种测试间UA串味的糟心事，核心原因就是Capybara的会话状态在测试之间没被彻底隔离，带标签测试设置的自定义UA会“偷偷”传给后续无标签的测试。下面是几个我亲测有效的解决办法：

1. 用RSpec around 钩子做前后清理（推荐） #

这是最精准的方案，给带标签的测试单独做UA设置+重置，不影响其他测试：

# 在rspec_helper.rb中添加配置
RSpec.configure do |config|
  # 提前保存默认UA，避免每次重复获取
  default_user_agent = Capybara.current_session.driver.browser.user_agent

  config.around(:example, :custom_ua) do |example|
    # 支持通过标签参数传自定义UA，比如it 'xxx', custom_ua: '三星浏览器UA字符串'
    target_ua = example.metadata[:custom_ua] || '默认自定义UA'
    Capybara.current_session.driver.browser.header('User-Agent', target_ua)
    
    # 执行测试逻辑
    example.run
    
    # 测试结束后强制切回默认UA
    Capybara.current_session.driver.browser.header('User-Agent', default_user_agent)
  end
end

这样每次带:custom_ua标签的测试跑完，UA都会被立刻重置，不会污染后续测试。

2. 全局强制重置会话（彻底但稍慢） #

如果上面的方法还存在泄漏，可以更彻底一点，让每个测试都用全新的Capybara会话：

RSpec.configure do |config|
  config.before(:each) do
    # 重置所有会话状态
    Capybara.reset_sessions!
    # 手动重置UA为webkit默认值
    webkit_default_ua = Capybara::Webkit::Browser.new.user_agent
    Capybara.current_session.driver.browser.header('User-Agent', webkit_default_ua)
  end
end

这个方法会略微增加测试启动时间，但能彻底杜绝任何状态泄漏，适合状态污染严重的场景。

3. 同UA测试分组管理 #

如果你的自定义UA测试是批量的，可以把它们放到单独的上下文里统一处理：

describe '三星浏览器专属UI测试' do
  before(:context) do
    @original_ua = Capybara.current_session.driver.browser.user_agent
    # 设置三星浏览器UA
    Capybara.current_session.driver.browser.header('User-Agent', 'Mozilla/5.0 (Linux; Android 10; SM-G973F) AppleWebKit/537.36...')
  end

  after(:context) do
    # 测试组结束后切回原UA
    Capybara.current_session.driver.browser.header('User-Agent', @original_ua)
  end

  it '显示三星专属操作按钮' do
    # 测试逻辑
  end

  it '适配三星设备的布局规则' do
    # 测试逻辑
  end
end

这种方式适合同类型UA的测试批量处理，减少重复代码。

几个小提示 #

• 确保你的capybara-webkit版本支持header方法，旧版本可能需要用set_user_agent替代
• 如果测试中切换过驱动（比如using_driver），要确保重置逻辑对当前生效的驱动起作用
• 可以临时加个调试输出排查问题：

  config.after(:each) do
    puts "当前测试结束UA: #{Capybara.current_session.driver.browser.user_agent}"
  end
  

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