Docker容器启动时数据库初始化失败，热重载后恢复正常求助

核心原因 #

1. 容器启动顺序不匹配：Docker Compose默认并行启动所有容器，Go服务容器启动时，数据库容器可能还在进行初始化（比如加载数据、启动数据库服务进程），此时数据库并未就绪，导致连接被拒绝。而air热重载触发时，数据库容器已经完全启动完成，因此能正常建立连接。
2. 数据库连接参数未正确加载：报错信息中user= database=为空，说明启动时Go服务未正确读取到数据库用户名、数据库名等配置参数，可能是环境变量注入时机问题，热重载时配置重新加载才获取到正确参数。

解决方案 #

1. 确保容器启动顺序与数据库就绪状态 #

在docker-compose.yml中为数据库服务添加健康检查，让Go服务等待数据库完全就绪后再启动：

services:
  db:
    image: postgres:15 # 替换为你使用的数据库镜像
    healthcheck:
      # 根据数据库类型调整健康检查命令，比如MySQL用 "mysqladmin ping -h localhost"
      test: ["CMD-SHELL", "pg_isready -U ${DB_USER} -d ${DB_NAME}"]
      interval: 5s
      timeout: 5s
      retries: 5
    environment:
      - POSTGRES_USER=your_db_user
      - POSTGRES_PASSWORD=your_db_pass
      - POSTGRES_DB=your_db_name

  app:
    build: .
    depends_on:
      db:
        condition: service_healthy # 等待db服务处于健康状态再启动
    environment:
      - DB_HOST=db
      - DB_USER=your_db_user
      - DB_PASSWORD=your_db_pass
      - DB_NAME=your_db_name
      - DB_PORT=5432 # 替换为对应数据库端口

2. 修复数据库连接参数加载逻辑 #

检查Go项目的数据库初始化代码，确保正确从环境变量或配置文件读取参数，同时添加重试逻辑应对数据库未就绪的情况：

package main

import (
  "fmt"
  "log"
  "os"
  "time"

  "gorm.io/driver/postgres" // 根据数据库类型替换驱动
  "gorm.io/gorm"
)

func initDB() *gorm.DB {
  dsn := fmt.Sprintf("host=%s user=%s password=%s dbname=%s port=%s sslmode=disable",
    os.Getenv("DB_HOST"),
    os.Getenv("DB_USER"),
    os.Getenv("DB_PASSWORD"),
    os.Getenv("DB_NAME"),
    os.Getenv("DB_PORT"),
  )

  var db *gorm.DB
  var err error
  maxRetries := 10
  retryInterval := 2 * time.Second

  for i := 0; i < maxRetries; i++ {
    db, err = gorm.Open(postgres.Open(dsn), &gorm.Config{})
    if err == nil {
      // 验证连接是否可用
      sqlDB, _ := db.DB()
      if pingErr := sqlDB.Ping(); pingErr == nil {
        break
      }
    }
    log.Printf("数据库连接失败，%v后重试（第%d/%d次）", retryInterval, i+1, maxRetries)
    time.Sleep(retryInterval)
  }

  if err != nil {
    log.Fatalf("多次重试后仍无法连接数据库：%v", err)
  }
  return db
}

3. 验证air配置的环境变量加载 #

检查air.toml配置，确保热重载时不会丢失必要的数据库环境变量：

[build]
cmd = "go build -o ./tmp/main ./main.go"
bin = "./tmp/main"
include_ext = ["go", "tpl", "tmpl", "html"]
exclude_dir = ["assets", "tmp", "vendor"]
exclude_file = []
log = "air_errors.log"

[run]
args = []
env = ["DB_HOST=db", "DB_USER=your_db_user", "DB_PASSWORD=your_db_pass", "DB_NAME=your_db_name", "DB_PORT=5432"]
wait = 1000

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