升级Ruby 3后Capybara visit方法抛出参数数量错误问题咨询

报错核心是当前安装的selenium-webdriver 3.142.7版本不兼容Ruby 3.x。
Ruby 3.0开始对参数传递规则做了不兼容调整：严格分离关键字参数和位置哈希参数，移除了Ruby 2.7时代的自动转换兼容逻辑。3.x系列的selenium-webdriver全部基于Ruby 2.x的参数规则编写，调用底层方法时会出现参数解析错位，就会出现调试时看到的反常报错：传入1个参数提示期望0个参数，传入0个参数又提示期望1个参数。
这个问题和Capybara本身无关，所有需要触发Selenium驱动初始化的Capybara方法（visit、fill_in、click_on等）都会抛出同类错误。你升级时仅变更了Ruby、Bundler版本和运行平台，没有升级Capybara，也就没有同步升级Capybara依赖的selenium-webdriver版本——3.142.7是Selenium 3系列的最终封版版本，发布时间远早于Ruby 3正式版，官方从未给这个版本做过Ruby 3适配。

按需选择以下任意一种方案修复即可：

• （推荐）升级selenium-webdriver到4.x及以上稳定版本。Selenium 4.x系列全版本原生适配Ruby 3参数规则，和你当前使用的Capybara 3.35.3版本完全兼容，无需修改任何测试代码。直接在项目根目录执行以下命令完成升级：

  bundle update selenium-webdriver
  

  升级完成后重新运行集成测试即可恢复正常。
• （临时过渡方案）如果因项目历史依赖限制暂时无法升级到Selenium 4，可以在Gemfile中添加专门适配Ruby 3的Selenium 3补丁gem selenium-webdriver-ruby3，安装后即可修复参数传递问题，不需要改动原有Selenium版本。注意这个方案仅适合短期过渡，长期维护还是建议升级到官方持续维护的Selenium 4版本。

注意：不要尝试通过降级Capybara、修改测试调用逻辑的方式修复，问题出在底层Selenium驱动的参数兼容层，上层逻辑调整无法解决根本问题。

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