Rails 5.2.6启动server时add_modifier参数数量错误无法运行求助

根因定位 #

你遇到的报错核心是Ruby版本和Rails版本不兼容：

• Rails 5.2.x 官方最高仅支持 Ruby 2.7.x 系列，未适配 Ruby 3.0+ 的语法变更
• Ruby 3.0 引入了关键字参数与普通参数分离的规则，Rails 5.2 中未适配的方法调用会把关键字参数误判为额外的普通参数，从而抛出wrong number of arguments (given 3, expected 2)的错误
• 你之前运行正常是因为旧的Gemfile.lock锁定了临时兼容的低版本依赖，重新生成lock文件后依赖自动升级，触发了兼容问题

修复方案 #

方案一（推荐，稳定性最高）：降级Ruby到2.7.x系列 #

1. 执行命令安装Ruby 2.7.x最新稳定版：rbenv install 2.7.8
2. 切换到项目目录，设置项目本地Ruby版本：rbenv local 2.7.8
3. 删除当前的Gemfile.lock文件，重新执行依赖安装：bundle install
4. 重启rails server即可恢复正常

方案二（仅用于临时调试，不推荐上生产）：添加Ruby3兼容补丁 #

如果暂时无法降级Ruby版本，可以通过手动打补丁的方式适配语法：

1. 在项目config/initializers/目录下新建补丁文件active_record_ruby3_compat.rb
2. 写入以下代码：

module ActiveRecord
  module Type
    class AdapterSpecificRegistry < ActiveRecord::Type::Registry
      def add_modifier(type, modifier, **options)
        mod = registry[type]
        mod = mod.respond_to?(:call) ? modifier.call(mod) : mod
        register(type, mod, **options)
      end
    end
  end
end

3. 重启rails server即可解决报错

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