Selenium Firefox配置unexpectedAlertBehaviour报非法键值错误如何解决

报错由版本适配规则不匹配触发：

• 拉取的selenium/standalone-firefox镜像默认标签为最新版，内置的Geckodriver严格遵循W3C WebDriver标准，仅识别标准定义的能力键，旧版JSON Wire协议中驼峰格式的unexpectedAlertBehaviour属于非法键。W3C标准中对应弹窗行为的配置键为unhandledPromptBehavior。
• 当前使用的Capybara 2.11.0版本发布于2017年，未适配新版W3C协议规范，即使用户手动删除自定义capabilities配置，框架内置的Firefox驱动注册逻辑仍会自动注入旧格式的unexpectedAlertBehaviour参数，这也是删除自定义配置后报错仍存在的原因。
• Chrome配置未触发同类错误，是因为Chrome驱动对旧协议参数做了向下兼容，而新版Geckodriver遇到非标准能力键会直接抛出错误终止启动。

两种方案二选一即可，优先选择第一种适配新版协议的方案。

方案1：修改驱动配置适配W3C标准（推荐） #

弃用旧的Selenium::WebDriver::Remote::Capabilities配置方式，参考现有Chrome的配置逻辑，使用Firefox::Options传参：

Capybara.register_driver :headless_firefox do |app|
  # 清除Capybara旧版本内置的非标准Firefox配置，避免自动注入非法键
  Capybara::Selenium::Driver::FIREFOX_OPTIONS.clear if defined?(Capybara::Selenium::Driver::FIREFOX_OPTIONS)

  options = Selenium::WebDriver::Firefox::Options.new
  options.add_argument('-headless')
  options.add_argument('--window-size=1280,800')
  # W3C标准下的弹窗行为配置，替代旧的unexpectedAlertBehaviour
  options.unhandled_prompt_behavior = :accept

  Capybara::Selenium::Driver.new(
    app,
    browser: :firefox,
    url: "http://firefox-server:4444",
    options: options
  )
end

Capybara.javascript_driver = :headless_firefox

方案2：固定Docker镜像版本适配旧技术栈 #

如果不想改动现有老项目代码，直接将Selenium Firefox镜像版本固定到兼容旧JSON Wire协议的3.141.59版本，修改docker-compose配置即可：

firefox-server:
    image: selenium/standalone-firefox:3.141.59-oxygen
    ports:
      - "7900:7900"
      - "4444:4444"

该方案无需修改Ruby侧代码，但无法使用新版Firefox、Selenium的新特性，适合维护周期长、改动成本高的遗留Rails项目。

配置修改后重启Selenium容器、重新执行测试，不再抛出Illegal key values seen in w3c capabilities错误即为修复成功。如果需要排查页面渲染、弹窗触发等问题，可访问http://localhost:7900通过noVNC查看容器内浏览器的实时运行界面，默认访问密码为secret。

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