Ruby新手接手2015年老旧Rails项目，Gem依赖冲突如何解决？

1. 先搞定Mimemagic版本缺失问题 #

老旧项目用的mimemagic旧版本（比如0.3.5）因版权问题已从RubyGems移除，直接安装会找不到，有两种解决方式：

• 锁定版本并指定源：在Gemfile中添加

  gem 'mimemagic', '0.3.5', source: 'https://rubygems.org'
  # 若官方源仍找不到，改用GitHub源
  # gem 'mimemagic', '0.3.5', git: 'https://github.com/mimemagicrb/mimemagic.git', tag: 'v0.3.5'
  

• 替换替代Gem：如果项目对mimemagic依赖不深，用ruby-filemagic替换，修改Gemfile：

  gem 'ruby-filemagic'
  

2. 统一Rails核心组件版本 #

actionpack、activemodel这类Rails核心Gem必须和项目指定的Rails主版本完全一致，别单独指定版本：

• 先看Gemfile里的Rails版本，比如gem 'rails', '4.2.0'，删掉所有单独指定核心组件（如actionpack、activemodel）版本的条目，让bundle自动匹配Rails主版本的依赖
• 运行bundle update --conservative rails，只更新Rails及其直接依赖，避免乱改其他Gem版本

3. 隔离本地Gem环境，避免全局干扰 #

本地已装的旧Gem会干扰依赖解析，直接搞独立环境：

• 用rbenv或rvm安装项目对应年代的Ruby版本（2015年的项目一般用Ruby 2.2.x或2.3.x），并切换到该版本
• 运行bundle install --path vendor/bundle，把所有Gem装到项目本地的vendor/bundle目录，彻底和全局Gem隔离开

4. 逐个啃剩余依赖冲突 #

看bundle报错里的具体冲突项，比如某Gem要求activesupport >=5.0，但项目Rails是4.2：

• 查该Gem的版本历史，找到支持当前Rails版本的最高兼容版，在Gemfile里锁定，比如：

  gem 'problem_gem', '~> 2.1.0' # 替换为实际兼容版本号
  

• 要是找不到兼容版，就找功能相似的替代Gem，比如用旧版本的carrierwave替换冲突的上传类Gem

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