macOS Big Sur安装Rails 4.1.6执行bundle install报gem兼容错误

• mimemagic 0.3.0版本下架：2021年该版本因许可证合规问题被RubyGems官方源移除，即使本地已安装，Bundler默认执行远程校验时也会抛出找不到版本的错误。
• brew update篡改环境配置：brew升级操作会调整/usr/local/bin下的软链接优先级，可能将系统Ruby路径前置到rbenv/rvm等版本管理工具的路径之前，导致Bundler读取的Ruby环境、gem安装路径和原有配置不一致，触发多依赖版本不兼容报错。
• Bundler版本不匹配：Rails 4.1.6配套适配Bundler 1.x版本，若brew update后升级到Bundler 2.x，其依赖解析规则差异会误判本地已存在的兼容版本。

• 修复环境路径
  优先确认Ruby版本管理器的配置有效性：
  • rbenv用户：执行rbenv version确认Ruby版本与原有配置一致，执行echo $PATH检查~/.rbenv/shims路径是否在/usr/local/bin之前，若顺序错误，将eval "$(rbenv init -)"写入shell配置文件（_/.zshrc或/.bash_profile）后重启终端。
  • rvm用户：执行rvm current确认Ruby版本正确，执行rvm use [你的Ruby版本号] --default固定默认版本。
• 降级Bundler到适配版本
  执行命令安装Rails 4.1.6兼容的Bundler版本：

  gem install bundler -v 1.17.3
  

  后续调用bundle时指定版本并添加本地安装参数，强制使用已安装的gem，跳过远程校验：

  bundle _1.17.3_ install --local
  

  90%以上本地已有兼容版本的报错可通过该命令直接解决。
• 修复mimemagic依赖异常
  若仍提示mimemagic版本缺失，二选一执行以下操作：
  • 方案一：覆盖版本限制
    在Gemfile中添加配置，使用合规的高兼容版本：

    gem 'mimemagic', '~> 0.3.10'
    

    执行bundle _1.17.3_ update mimemagic完成更新即可，该版本完全兼容paperclip 4.3.2的核心功能。
  • 方案二：本地缓存适配
    先安装mimemagic依赖的系统组件：

    brew install shared-mime-info
    

    执行bundle cache将本地已有的mimemagic 0.3.0加入Bundler缓存，再执行bundle _1.17.3_ install --local即可。
• 兜底处理
  若上述操作均无效，先备份Gemfile.lock文件，删除原文件后重新执行bundle _1.17.3_ install，Bundler会重新生成符合依赖规则的锁文件。

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