无法将Go应用推送至Heroku：构建失败

这种毫无征兆的构建失败确实很棘手——尤其是之前能正常部署的代码现在也跑不通了。结合你的情况，我整理了几个针对性的排查方向：

1. 清除Heroku构建缓存 #

Heroku会缓存Go依赖和构建产物，一旦缓存损坏，哪怕是旧的正常代码也会构建失败。你可以通过CLI清除缓存：

heroku builds:cache:purge -a your-app-name

执行完之后重新推送代码，让Heroku从头开始拉取依赖并构建。

2. 本地验证依赖与编译流程 #

有时候本地的依赖缓存和Heroku环境不一致，先确保本地能正常编译：

• 清理本地Go模块缓存：

  go clean -modcache
  

• 重新下载所有依赖：

  go mod download
  

• 本地编译应用，确认能生成bin/toto：

  go build -o bin/toto
  

如果本地编译失败，那问题出在代码或依赖上；如果本地正常，再推送到Heroku试试。

3. 获取更详细的构建日志 #

你提到日志没有有效信息，其实可以通过Heroku CLI获取构建环节的完整输出，这能帮你定位具体错误：

heroku logs --app your-app-name --tail --source build

这条命令会实时输出构建过程中的所有细节，比如依赖拉取失败、编译报错等，是排查这类问题的关键。

4. 检查Heroku Go环境的兼容性 #

虽然你的go.mod里指定了go 1.16，Heroku也用了go1.16.8，但可以确认下：

• 在Heroku的应用设置里，检查是否有手动设置的GOVERSION环境变量，和go.mod里的// +heroku goVersion go1.16是否冲突；
• 尝试在go.mod里把版本指定为具体的go1.16.8，和Heroku使用的版本完全一致，避免微小版本差异带来的隐性问题。

5. 排查间接依赖的问题 #

你的go.mod里有不少间接依赖，虽然之前能正常使用，但某些间接依赖的源可能出现访问问题，或者版本存在兼容性隐患。可以尝试：

• 执行go mod tidy整理依赖，确保所有间接依赖的版本是当前模块兼容的最新稳定版；
• 对于标注+incompatible的github.com/golang-jwt/jwt v3.2.2+incompatible，如果之前的版本没问题，可以先忽略，但如果排查到最后还是没头绪，可以尝试升级到v4版本（注意需要修改代码中的导入路径）。

内容的提问来源于stack exchange，提问作者raphael.oester