Rails6更新Gem后启动控制台出现CompositeIO弃用警告排查

• 运行环境：Rails 6 项目，Ruby 版本为3.1.2，执行bundler update更新Gem依赖后，运行bin/rails c启动控制台时出现弃用提示
• 完整弃用提示内容：

root@1ddbacaf4a69:/app# bin/rails c
Top level ::CompositeIO is deprecated, require 'multipart/post' and use `Multipart::Post::CompositeReadIO` instead!
Top level ::Parts is deprecated, require 'multipart/post' and use `Multipart::Post::Parts` instead!

• 排查需求：不通过逐个禁用Gem的方式，直接定位导致问题的不兼容依赖组合

这个警告和Ruby 3.1.2版本本身没有关联，触发逻辑非常明确：

• 警告来自multipart-post gem：从2.2.0版本开始，该Gem将顶层命名空间下的::CompositeIO、::Parts常量标记为弃用，要求开发者统一使用Multipart::Post命名空间下的CompositeReadIO、Parts实现。
• 触发警告的直接原因是项目中某个依赖Gem没有适配multipart-post的新命名空间规则，加载时仍然直接调用顶层的旧常量。Rails 6框架本身没有相关调用逻辑，问题全部来自第三方依赖。
• 最常见的触发源是版本低于1.10.0的faraday，其次是旧版本的httparty、老版aws-sdk系列组件。

不需要逐个禁用Gem排查，直接执行以下命令即可定位问题：

1. 先确认当前安装的multipart-post版本：

   bundle show multipart-post
   

   如果返回的版本号 >= 2.2.0，就符合触发警告的前提条件。
2. 直接搜索所有已安装Gem中调用旧常量的位置，一步定位问题源：

   bundle grep "::CompositeIO" --gems
   

   命令返回结果里对应的Gem就是导致警告的不兼容依赖。

修复方案二选一即可：

• 如果定位到的问题Gem已经发布适配版本（比如faraday 1.10.0及以上版本已经完成适配），直接将对应Gem升级到适配版本，执行bundle update <问题Gem名>后重启控制台即可。
• 如果对应Gem暂时没有发布适配版本，可以在项目Gemfile中临时锁定multipart-post到未做弃用标记的最后一个版本，等依赖适配完成后再解锁：

  # Gemfile中添加以下行
  gem 'multipart-post', '2.1.1'
  

  执行bundle update multipart-post后重启控制台，警告就会完全消失。

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