Ruby3+Rails6环境下Watir初始化火狐浏览器报参数错误如何解决？

关于是否需要引入watir-rails依赖 #

watir-rails不是强制依赖：

• 如果你是在Rails项目中做系统测试、集成测试，引入它可以简化配置，比如自动适配测试环境、自动管理浏览器启停生命周期，降低接入成本
• 如果是非Rails项目、或者仅用Watir写独立脚本，完全不需要引入该依赖

初始化浏览器报错的修复方案 #

你猜测的原因是正确的：该报错是Ruby 3不再支持隐式哈希转关键字参数的特性导致的，你当前使用的selenium-webdriver 3.142.7、以及配套的低版本Watir没有适配Ruby 3的传参规则，调用底层驱动时参数传递格式不匹配。

按照以下步骤修复即可：

1. 升级依赖到兼容Ruby 3的版本
   修改Gemfile中的版本约束，将相关组件升级到适配版本：

gem 'watir', '~> 7.0' # 7.0及以上版本已完全适配Ruby 3 + Selenium 4
gem 'selenium-webdriver', '~> 4.0'
gem 'webdrivers', '~> 5.0'

执行更新命令：
bundle update watir selenium-webdriver webdrivers

2. 验证调用
   升级完成后原有的Watir::Browser.new :firefox调用无需修改即可正常运行。如果需要传递自定义配置，需要明确使用关键字参数格式，示例如下：

# 火狐无头模式启动示例
firefox_options = Selenium::WebDriver::Firefox::Options.new
firefox_options.add_argument('--headless')
browser = Watir::Browser.new :firefox, options: firefox_options

如果受其他依赖限制暂时无法升级大版本，可以给项目添加临时补丁适配传参规则，但更推荐升级到官方兼容版本，避免后续出现其他兼容性问题。

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