Azure Web App中Go API连接数据库失败，报CGI应用错误

核心错误分析 #

"The specified CGI application encountered an error and the server terminated the process."

这个错误通常并非数据库连接直接导致，而是Azure Web App运行Go程序时的环境配置、启动方式或依赖问题引发程序崩溃，进而触发CGI错误。结合本地运行正常、部署后连AWS/Azure数据库均报错的情况，重点排查以下几点：

具体排查步骤 #

• 环境变量配置问题
  本地通过godotenv加载.env文件，但Azure Web App不会自动读取该文件，需在Azure门户的「配置」→「应用程序设置」中手动添加所有数据库相关环境变量（DB_DRIVER、DB_PORT、DB_HOST等）。注意变量名要与代码中完全一致，值不能有多余空格。
  另外，代码中DB, err := gorm.Open(...)属于重新声明变量，覆盖了全局的var DB *gorm.DB，若后续代码调用全局DB会触发空指针错误，应改为：

  var err error
  DB, err = gorm.Open(mysql.Open(dsn), &gorm.Config{})
  

• Azure Web App的Go运行时配置
  确保Azure Web App的运行时设置正确：

  • 在「配置」→「常规设置」中，设置「启动命令」为你的可执行文件名（例如./your-api），不要依赖默认的CGI启动方式——Go程序是独立二进制文件，无需CGI托管。
  • 检查运行时版本与本地开发使用的Go版本一致，避免版本兼容问题。

• 数据库网络访问权限
  Azure Web App默认从公网访问数据库，需确保：

  • AWS RDS/Azure SQL数据库的安全组/防火墙规则允许Azure Web App的出站IP访问。可在Azure门户的「属性」中获取Web App的出站IP列表，将其添加到数据库的白名单中。
  • 数据库的DB_HOST需填写公网地址，不要使用内网地址（除非配置了VNet集成）。

• 错误日志排查
  开启Azure Web App的日志功能：在「监控」→「日志流」中查看实时日志，或下载日志文件，获取程序崩溃的具体错误信息（如数据库连接超时、环境变量缺失、依赖库缺失等），这是定位问题最直接的方式。

• 依赖打包问题
  本地开发的依赖可能与Azure环境不兼容，部署前需在Linux环境下交叉编译（Azure Web App默认使用Linux容器），命令如下：

  CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o your-api main.go
  

  确保编译后的二进制文件不依赖系统库，避免Azure环境缺少依赖导致程序崩溃。

额外优化建议 #

• 代码中添加完善的错误处理，比如数据库连接失败时打印详细错误信息：

  DB, err = gorm.Open(mysql.Open(dsn), &gorm.Config{})
  if err != nil {
      log.Fatalf("数据库连接失败: %v", err)
  }
  

  这样日志中会保留具体错误原因，便于快速排查。

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