运行rails server时报ArgumentError (given 3, expected 2)错误

Rails 5.2 与当前环境的 Ruby 3.1、Rack 2.2.3.1 版本不兼容，是报错的核心原因：

• Rails 5.2 官方最高仅支持 Ruby 2.7 系列，Ruby 3.0 及以上版本调整了参数校验、关键字参数传递逻辑，会直接触发 Rails 框架内部的方法调用错误。
• Rack 2.1+ 版本修改了静态文件中间件的初始化方法签名，从原来接收3个入参改为仅接收2个，Rails 5.2 内置的中间件调用逻辑没有适配这个变更，直接触发参数数量不匹配的ArgumentError。
  隔很久启动才触发，基本是这段时间内全局更新过 Ruby 版本，或者执行bundle update时没有加版本约束，把依赖升级到了不兼容的新版本。

• 执行ruby -v确认当前运行的 Ruby 版本，执行bundle list | grep rack确认项目实际加载的 Rack 版本，核对是否符合 Rails 5.2 的兼容范围。
• 检查项目根目录的 Gemfile、.ruby-version 文件，确认是否存在版本约束缺失，导致依赖自动升级到不兼容版本。
• 如果本地用了 rbenv/RVM 等 Ruby 版本管理器，检查全局默认 Ruby 版本是否被改动，进入项目目录后有没有自动切换到项目指定的 Ruby 版本。

按优先级排序选择：

• 方案一（长期推荐）：升级 Rails 到 6.1 及以上版本，原生兼容 Ruby 3.0+ 和新版 Rack，从根源避免后续出现其他兼容性问题。
• 方案二（快速修复，不升级 Rails）：降级 Ruby 和 Rack 到兼容版本，步骤如下：
  1. 安装 Ruby 2.7.x（推荐2.7.7，是2.7系列最终稳定版），在项目根目录新建.ruby-version文件写入对应版本号，确保进入项目目录自动切换到正确版本。
  2. 打开项目根目录的 Gemfile，添加一行版本约束：gem 'rack', '~> 2.0.0'
  3. 执行bundle update rack安装适配版本的 Rack 依赖。
  4. 执行bin/rails tmp:clear清空项目缓存和 Bootsnap 编译缓存，避免旧缓存代码干扰。
  5. 重新执行rails server启动即可。
• 方案三（临时调试用，不推荐生产环境）：如果暂时不想切换 Ruby 版本，可以手动给 Rails 5.2 打兼容补丁，重写静态文件中间件的初始化方法适配新版 Rack 参数签名，同时补上 Ruby 3.1 下其他关键字参数传递的兼容逻辑，但后续大概率还会碰到其他框架层面的兼容报错，维护成本很高。

注意：如果切换版本后还是报同样的错，优先检查 Bootsnap 缓存，直接删除项目根目录下tmp/cache文件夹再重启，基本都能解决缓存导致的代码加载异常。

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