升级至Rails 6.0后Heroku推送失败，疑为Bundler问题

我之前帮朋友排查过几乎一模一样的问题——本地环境版本和Gemfile.lock完全对应，但Heroku就是报错找不到指定的Bundler版本。核心原因是Heroku的构建环境要么缓存了旧依赖，要么默认Ruby buildpack在处理Bundler 2.x时存在小坑，下面是一步步的解决方案：

1. 确保Heroku使用和本地一致的Ruby版本 #

虽然你本地是2.6.3，但Heroku可能默认使用了其他Ruby版本，这会间接导致Bundler依赖冲突。先在Gemfile顶部添加明确的版本声明：

ruby '2.6.3'

然后运行bundle install更新Gemfile.lock，把变更提交到Git：

git add Gemfile Gemfile.lock
git commit -m "Specify Ruby version 2.6.3"

2. 清除Heroku的构建缓存 #

Heroku会缓存之前的构建依赖，旧版本Bundler很可能残存在缓存里干扰新构建。执行命令清除缓存：

heroku repo:purge_cache -a aloop-staging

3. 强制Heroku安装指定版本的Bundler #

有两种方式可以让Heroku明确安装你需要的Bundler 2.0.2：

方式A：通过环境变量设置 #

直接在Heroku上配置环境变量，指定Bundler版本：

heroku config:set BUNDLE_VERSION=2.0.2 -a aloop-staging

方式B：通过.bundle/config文件配置 #

在项目根目录创建（如果不存在）.bundle/config文件，添加以下内容：

---
BUNDLE_VERSION: "2.0.2"

然后把这个文件提交到Git：

git add .bundle/config
git commit -m "Set Bundler version to 2.0.2"

4. 重新推送代码 #

完成以上步骤后，再次推送代码到Heroku：

git push heroku your-branch-name:main

为什么本地没问题但Heroku报错？ #

本地环境是你长期维护的，已经预装了对应版本的Bundler；但Heroku的构建环境是临时创建的（或缓存了旧状态），当它读取Gemfile.lock里的BUNDLED WITH 2.0.2时，需要主动安装这个版本的Bundler才能继续构建。上面的步骤就是强制Heroku完成这个安装动作，同时确保Ruby版本一致，避免依赖冲突。

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