如何修复Gem安装失败导致的Heroku master分支推送问题？

• 对齐本地Gemfile和Gemfile.lock版本
  本地执行bundle install，确保Gemfile.lock是最新状态，把Gemfile和Gemfile.lock都提交到git后再重新推送。Heroku完全依赖Gemfile.lock安装gem，两者版本不匹配大概率会触发安装失败。

• 拆分开发/测试环境的Gem
  把只在本地使用的gem（比如sqlite3、byebug、rspec这类）放到development和test组里，示例：

  group :development, :test do
    gem 'sqlite3'
    gem 'byebug'
    gem 'rspec-rails'
  end
  
  group :production do
    gem 'pg'
  end
  

  Heroku默认只安装production组的gem，别把本地专属gem丢到全局组里，否则会因依赖缺失或环境不兼容报错。

• 排查Gem版本兼容性
  有些Gem指定的版本可能和Heroku上的Ruby/Rails版本不兼容，试试去掉特定Gem的版本号，让Bundler自动匹配兼容版本；也可以先通过heroku run ruby -v查看Heroku当前的Ruby版本，再对应找支持该版本的Gem。

• 清理Bundler缓存
  本地先执行bundle clean --force，再重新bundle install，更新Gemfile.lock后提交推送。也可以清空Heroku的缓存：先安装插件heroku plugins:install heroku-repo，再执行heroku repo:purge_cache -a rails-watch-list-93，之后再推送代码。

• 查看完整错误日志找根源
  你收到的错误信息太笼统，执行heroku logs --tail -a rails-watch-list-93能看到Bundler安装失败的具体细节，比如某个Gem缺少系统依赖、版本冲突等，根据具体日志再针对性解决。

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