Rails 8迁移遇ActiveSupport::ProxyObject弃用问题，求解决方案

问题描述 #

从Rails 7.1升级到7.2时，会弹出以下弃用警告：

DEPRECATION WARNING: ActiveSupport::ProxyObject is deprecated and will be removed in Rails 8.0.
Use Ruby's built-in BasicObject instead.
(called from

at .../config/application.rb:7)

警告指向config/application.rb里的这行代码：

# Require the gems listed in Gemfile, including any gems
# you've limited to :test, :development, or :production.
Bundler.require(*Rails.groups)

当执行rails app:update升级到Rails 8时，会触发加载错误：

/Users/deploy/.rbenv/versions/3.3.0/lib/ruby/3.3.0/bundled_gems.rb:74:in require': cannot load such file -- active_support/basic_object (LoadError) [... and a bit later a curious entry ...] from bin/rails:4:in

'
/Users/deploy/.rbenv/versions/3.3.0/lib/ruby/3.3.0/bundled_gems.rb:74:in `require': cannot load such file -- active_support/proxy_object (LoadError)

问题原因 #

• 警告并非来自Bundler.require本身，而是某个项目依赖的gem（非Rails核心代码）内部使用了ActiveSupport::ProxyObject，当Bundler.require加载这些gem时触发了警告。
• Rails 8.0彻底移除了ActiveSupport::ProxyObject类以及active_support/basic_object文件，依赖这些API的gem会因找不到对应文件触发加载错误。

解决步骤 #

1. 定位问题gem
   执行以下命令，搜索所有依赖gem中使用ActiveSupport::ProxyObject或active_support/basic_object的文件：

   bundle show | xargs grep -l "ActiveSupport::ProxyObject\|active_support/basic_object"
   

   该命令会输出所有涉及问题API的gem名称。

2. 更新或替换问题gem

   • 查看该gem的官方仓库或版本日志，确认是否有兼容Rails 8的版本，直接升级即可。
   • 如果gem已停止维护，可选择功能类似的替代gem；也可以fork该gem，将代码中所有ActiveSupport::ProxyObject替换为Ruby原生的BasicObject，同时移除require 'active_support/basic_object'的语句。

3. 临时过渡方案
   如果暂时无法更新或替换gem，可在config/application.rb的最顶部添加以下代码，模拟已被移除的API，临时规避错误：

   unless defined?(ActiveSupport::ProxyObject)
     ActiveSupport::ProxyObject = BasicObject
   end
   

   注意：这仅作为临时过渡手段，长期仍需修复依赖gem的兼容性问题，避免后续版本出现更多异常。

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