更换aws-sdk-s3 gem后Heroku应用崩溃，本地运行正常求助

我刚遇到了一模一样的情况：把Gemfile里的全量aws-sdk换成轻量化的aws-sdk-s3后本地跑的好好的，一推Heroku就崩，还弹出了堆栈过时的警告。折腾了一会儿终于搞定，分享下我的解决步骤：

先排查代码里的遗留引用 #

最常见的原因是代码里还在调用旧的全量SDK，哪怕你换了gem，只要有require 'aws-sdk'或者旧的命名空间调用，Heroku就会找不到这个gem报错：

• 全局搜索项目里的require 'aws-sdk'，全部替换成require 'aws-sdk-s3'
• 检查S3的初始化代码，旧写法是AWS::S3.new(...)，新版要改成Aws::S3::Client.new(...)或者Aws::S3::Resource.new(...)，别搞混了命名空间！

强制Heroku清缓存重部署 #

Heroku有时候会缓存旧的gem依赖，哪怕你更新了Gemfile也没用。执行这两条命令清缓存再部署：

heroku repo:purge_cache -a 你的应用名称
git push heroku main

别忘了更新并提交Gemfile.lock #

本地改完Gemfile后，一定要跑bundle install更新Gemfile.lock，然后把这个文件和Gemfile一起提交到Git，不然Heroku还是会用旧的依赖列表：

bundle install
git add Gemfile Gemfile.lock
git commit -m "替换全量aws-sdk为aws-sdk-s3"
git push heroku main

关于过时堆栈的警告（可选但建议处理） #

虽然这个警告不是直接导致崩溃的原因，但旧堆栈可能会有兼容性问题，长期来看还是升级比较好：

• 先查看当前使用的堆栈：heroku stack
• 切换到最新的稳定堆栈（比如heroku-22）：heroku stack:set heroku-22 -a 你的应用名称
• 重新部署一次就生效了

内容的提问来源于stack exchange，提问作者bo-oz