Azure Web App部署Go应用遇阻：自定义启动命令与GitHub Actions求助

核心方案：上传预构建可执行文件部署 #

要让Azure直接运行预构建的可执行文件、跳过自动构建，按以下步骤操作：

1. 在GitHub Actions中编译Linux兼容的可执行文件
   Azure App Service Linux环境基于amd64架构，编译时必须指定对应平台参数，确保可执行文件能正常运行。在Workflow中添加编译步骤：

   - name: 配置Go环境
     uses: actions/setup-go@v4
     with:
       go-version: '1.21' # 替换为你的项目Go版本
   
   - name: 编译Go应用
     run: |
       GOOS=linux GOARCH=amd64 go build -o main ./cmd # 若main.go在根目录，路径改为./main.go
       chmod +x main # 赋予可执行权限
   

2. 部署预构建文件并指定启动命令
   使用azure/webapps-deploy@v2时，直接指定上传编译好的main文件，同时设置启动命令为./main，避免Azure触发自动构建：

   - name: 部署到Azure Web App
     uses: azure/webapps-deploy@v2
     with:
       app-name: ${{ secrets.AZURE_WEBAPP_NAME }}
       publish-profile: ${{ secrets.AZURE_WEBAPP_PUBLISH_PROFILE }}
       package: ./main # 仅上传预构建的可执行文件
       startup-command: './main'
   

3. 关闭Azure自动构建（推荐）
   进入Azure Portal的App Service配置页，找到「部署中心」，将部署模式改为「手动」，彻底避免Azure自动拉取代码构建。

解决cmd目录下代码直接部署的启动命令问题 #

如果选择直接推送代码到Azure，而非预构建，按以下方式修复：

• 不要用go run cmd/main.go作为启动命令（生产环境效率低且依赖Go环境），正确做法是让Azure部署时先构建可执行文件：
  1. 在Azure App Service的「配置」→「常规设置」中，设置构建命令为go build -o main ./cmd
  2. 设置启动命令为./main
• 确保go.mod和go.sum在项目根目录，Azure会自动识别Go模块并安装依赖。

常见问题排查 #

• 可执行文件无法运行：检查编译时是否指定了GOOS=linux GOARCH=amd64，平台不兼容会导致文件无法执行。
• 权限不足：在编译后添加chmod +x main步骤，或者将启动命令改为chmod +x main && ./main。
• Azure仍自动构建：检查是否上传了多余的代码文件（如.go、go.mod），部署时仅上传可执行文件和必要配置文件即可。

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