部署 Go Web 应用至 AWS Elastic Beanstalk 失败，常因 ZIP 包结构错误所致：必须直接压缩源码文件（含 application.go、Procfile 等），而非压缩整个项目文件夹；否则 EB 无法识别入口文件，导致启动失败。
部署 go web 应用至 aws elastic beanstalk 失败，常因 zip 包结构错误所致：必须直接压缩源码文件（含 `application.go`、`procfile` 等），而非压缩整个项目文件夹；否则 eb 无法识别入口文件，导致启动失败。
AWS Elastic Beanstalk 对 Go 应用的部署包有严格目录结构要求。EB 在解压上传的 ZIP 文件后，会直接在归档根目录下查找可执行文件（如 application）或构建入口（如 main.go 或 Procfile）。若你将整个项目文件夹（例如 my-go-app/）选中并压缩，生成的 ZIP 内部结构为：
my-go-app.zip
└── my-go-app/
├── main.go
├── Procfile
└── go.mod此时 EB 实际工作路径为 my-go-app/ 的父级，无法找到 main.go 或 Procfile，从而构建失败或返回 502/503 错误。
✅ 正确做法是：进入项目目录，选中所有必要文件与子目录（不包括外层文件夹本身），再进行压缩。例如，在终端中执行：
# 假设当前在项目根目录（包含 main.go、Procfile、go.mod） zip -r ../myapp-deploy.zip .
或使用图形界面时，打开 my-go-app/ 文件夹 → 全选内容（Cmd+A / Ctrl+A）→ 右键“压缩为 ZIP”。
✅ 典型合规 ZIP 根目录应直接包含以下至少一项：
- main.go（EB 将自动 go build 生成 application）
- Procfile（显式声明启动命令，例如 web: ./application）
- 已编译的可执行文件 application（需 chmod +x application）
⚠️ 注意事项：
- 不要包含 .git、node_modules、vendor/（除非显式需要）等冗余目录；
- go.mod 和 go.sum 必须存在，确保 EB 使用 Go Modules 构建；
- 若使用 Procfile，请确保其无 BOM、换行符为 LF（Unix 风格），且首行无空格；
- 本地可模拟验证：unzip -l myapp-deploy.zip 检查顶层是否为源文件，而非嵌套文件夹。
总结：Elastic Beanstalk 的 Go 部署本质是“扁平化交付”——ZIP 即部署根目录。一次错误的“文件夹级压缩”即可导致整个部署链路中断。养成 cd your-app && zip -r app.zip . 的习惯，可规避 90% 的基础部署问题。
