Rails用Capybara+selenium-webdriver跑系统测试报ArgumentError错误
这个报错是Selenium WebDriver 3.x 版本与Chrome 88+ 的W3C协议交互逻辑不兼容导致的,并非Capybara配置的基础写法有误。
栈追踪里显示的handshake方法参数数量不匹配的错误,是非常有迷惑性的假象:你当前使用的selenium-webdriver 3.142.7,在和远程Chrome Hub建立连接时,对旧版非标准capabilities格式的响应解析逻辑,无法适配ChromeDriver 88开始默认启用的W3C WebDriver标准协议,解析过程中错把响应结构当方法参数传递,才触发了参数数量不符的报错。
1. 修正Capabilities的传参格式
你当前配置里把chromeOptions作为根节点键传给Selenium,这是ChromeDriver旧版本支持的非标准写法,ChromeDriver 88开始会严格按照W3C规范解析字段,要求Chrome专属的配置必须放在带goog:前缀的标准命名空间下,同时移除和headless模式、窗口尺寸配置冲突的start-maximized参数(该参数在headless环境下无效,且会和手动设置的窗口尺寸逻辑冲突)。
修正后的驱动注册代码如下:
Capybara.register_driver :chrome_headless do |app| media_tab_screen_size = '1280,800' chrome_capabilities = Selenium::WebDriver::Remote::Capabilities.chrome( loggingPrefs: { browser: 'ALL', client: 'ALL', driver: 'ALL', server: 'ALL' }, 'goog:chromeOptions' => { args: %W[no-sandbox disable-dev-shm-usage no-default-browser-check headless disable-gpu window-size=#{media_tab_screen_size}] } ) if ENV['HUB_URL'] Capybara::Selenium::Driver.new(app, browser: :remote, url: ENV['HUB_URL'], desired_capabilities: chrome_capabilities) else Capybara::Selenium::Driver.new(app, browser: :chrome, desired_capabilities: chrome_capabilities) end end
2. 修正Docker网络下的服务地址配置
你当前用IPSocket.getaddress(Socket.gethostname)获取的主机IP,在Docker容器网络环境下大概率会拿到容器内部的回环地址或独立网段地址,等握手问题解决后,马上会遇到Selenium Hub容器无法访问Rails测试服务的问题。
需要把RSpec配置里的主机参数调整为Docker网络可识别的地址:
- 将
Capybara.app_host调整为docker-compose里web服务的服务名,例如"http://web:3000",让Selenium Hub容器通过Docker内部DNS直接定位Rails服务 - 将
Capybara.server_host调整为'0.0.0.0',允许Rails测试服务监听所有网络接口,而不是仅绑定容器内部的回环地址
修正后的RSpec配置片段:
RSpec.configure do |config| driven_by :chrome_headless # 适配Docker内部网络 Capybara.app_host = "http://web:3000" Capybara.server_host = '0.0.0.0' Capybara.server_port = 3000 end
3. 版本兼容校验
不要随意跨大版本升级gem,当前组合下的匹配关系为:
selenium-webdriver 3.142.7可完全兼容selenium/standalone-chrome:88.0镜像- 如果后续要升级Chrome镜像版本,建议同步将selenium-webdriver升级到4.x大版本,再配套调整capabilities的写法,避免再次出现协议不兼容的问题
内容的提问来源于stack exchange,提问作者Himmelspiegel

