ElasticBeanstalk构建含Go modules的Go应用无明确原因失败问题

问题根因 #

Elastic Beanstalk 官方提供的 Go 运行环境（Amazon Linux 2 版本）默认构建逻辑对 Go Modules 支持不友好：

• 启用 Go Modules 时默认没有自动设置GO111MODULE=on环境变量，构建脚本会优先走旧的GOPATH模式，找不到依赖路径
• 默认构建流程不会自动执行依赖拉取操作，直接执行构建会因为依赖缺失失败
• 控制台默认不展示构建阶段的详细错误，所以你看不到具体失败原因

排查方法 #

你可以直接登录部署环境的EC2实例，查看/var/log/eb-engine.log文件，就能看到构建阶段的具体报错信息。也可以在实例的/var/app/staging目录下手动执行go build命令，复现构建过程，确认本地代码无语法问题。

解决步骤 #

方案一：保留在线构建逻辑，新增EB扩展配置 #

1. 在项目根目录新建.ebextensions文件夹，在文件夹内新建名为go_build.config的配置文件，写入以下内容：

option_settings:
  aws:elasticbeanstalk:application:environment:
    GO111MODULE: "on"
    # 国内部署可以替换为GOPROXY: "https://goproxy.cn,direct"
    GOPROXY: "https://proxy.golang.org,direct"

commands:
  download_go_deps:
    command: "go mod download"
    cwd: "/var/app/staging"

2. 重新打包项目：将application.go、go.mod、go.sum和.ebextensions目录直接放在zip压缩包的根目录，不要套外层文件夹，否则EB无法识别配置文件。
3. 重新上传zip包部署即可。

方案二：本地预编译跳过平台构建流程 #

你也可以本地先交叉编译出Linux平台的可执行文件，直接上传编译产物，完全绕过平台的构建逻辑，也不会触发Modules相关的问题，适合需要控制构建版本的场景：

1. 本地执行交叉编译命令：

CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o application .

2. 只将编译生成的application可执行文件打包为zip，直接上传部署即可。

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