使用Puma时nio4r因不支持的后端报错(ArgumentError)

问题根源 #

你遇到的unsupported backend: (ArgumentError)报错，核心原因是Puma 6.3.0与nio4r 2.5.2版本不兼容。Puma 6.x系列对nio4r的最低版本要求提升到了2.5.8，而你锁定的nio4r 2.5.2无法满足Puma 6.x的调用逻辑，导致初始化选择器时无法识别后端驱动。

可行解决方案 #

方案1：回退Puma到兼容版本

你的Rails 5.2.5版本更适配Puma 5.x系列，在Gemfile中指定兼容版本：

gem 'puma', '~> 5.6'

执行命令更新依赖：

bundle install

方案2：升级nio4r到兼容版本

若需保留Puma 6.x，将nio4r升级到2.5.8及以上版本（该版本兼容Puma 6.x且支持Ruby 2.7），在Gemfile中指定：

gem 'nio4r', '~> 2.5.8'

执行命令更新：

bundle update nio4r

额外排查点

如果上述方案无效，可检查系统是否缺少nio4r依赖的底层库：

• Linux：安装libev-dev或libuv-dev
• macOS：通过Homebrew安装libev或libuv
  之后重新编译nio4r：

bundle exec gem pristine nio4r

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