升级至Rails 7.2.0后Capybara测试报Rack::Handler未初始化错误

问题原因 #

Rails 7.2.0默认依赖的Rack 3.x+版本已废弃并移除了Rack::Handler模块，而你当前使用的Capybara 3.39.x版本未适配该变更，代码中仍尝试调用Rack::Handler::Puma，因此触发NameError。

解决方案 #

方案1：升级Capybara至兼容版本 #

Capybara从3.40.0版本开始已适配Rack 3.x的变化，移除了对Rack::Handler的依赖。操作步骤：

• 修改Gemfile中的Capybara声明：

  gem 'capybara', '>= 3.40.0'
  

• 执行命令更新依赖：

  bundle update capybara
  

方案2：添加rack-handler gem（临时兼容方案） #

若暂时不想升级Capybara，可通过安装官方分离出的rack-handler gem恢复Rack::Handler模块：

• 在Gemfile中添加：

  gem 'rack-handler'
  

• 执行命令安装依赖：

  bundle install
  

完成任一操作后，重新运行Capybara测试即可解决该错误。

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