GO+Gorm+Postgres+Docker环境下数据库连接失败求助

你的错误核心是数据库连接参数不匹配+容器间通信配置错误+数据库未就绪时后端提前启动，以下是针对性修复步骤：

1. 修复DSN的密码与主机名 #

你的docker-compose.yml中Postgres的密码是postgres，但代码里DSN用的是1234；同时容器间通信应该用服务名db而非自动生成的容器名amazon-shopping-backend-db-1（Docker Compose中服务名默认作为容器间DNS别名）。

修改config/db.go中的DSN：

dsn := "postgresql://postgres:postgres@db:5432/postgres?sslmode=disable"

或用更直观的格式：

dsn := "host=db user=postgres password=postgres dbname=postgres port=5432 sslmode=disable TimeZone=Asia/Shanghai"

2. 解决数据库未就绪的问题 #

depends_on: [db]仅保证db容器先启动，但Postgres需要几秒完成初始化才能接受连接，后端启动时会因数据库未就绪导致连接拒绝。

方案A：给db服务加健康检查 #

修改docker-compose.yml的db服务，添加健康检查规则，确保后端只在数据库就绪后启动：

services:
  db:
    image: postgres
    volumes:
      - ./data/db:/var/lib/postgresql/data
    ports:
      - "5432:5432"
    environment:
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres
      - POSTGRES_DB=postgres
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres -d postgres"]
      interval: 5s
      timeout: 5s
      retries: 5
  backend:
    build:
      context: ./
      dockerfile: Dockerfile
    container_name: backend
    ports:
      - "${BACKEND_PORT}:${BACKEND_PORT}"
    depends_on: 
      db:
        condition: service_healthy  # 等待db健康检查通过
    environment:
      - BACKEND_PORT=${BACKEND_PORT}

方案B：后端添加连接重试逻辑 #

在Connect()函数中加入重试机制，避免因数据库未就绪直接panic：

import "time"
import "fmt"

func Connect() {
    var db *gorm.DB
    var err error
    maxRetries := 5
    retryDelay := time.Second * 2

    for i := 0; i < maxRetries; i++ {
        dsn := "host=db user=postgres password=postgres dbname=postgres port=5432 sslmode=disable TimeZone=Asia/Shanghai"
        db, err = gorm.Open(postgres.Open(dsn), &gorm.Config{})
        if err == nil {
            break
        }
        fmt.Printf("Failed to connect to database, retrying in %v... (%d/%d)\n", retryDelay, i+1, maxRetries)
        time.Sleep(retryDelay)
    }

    if err != nil {
        panic(fmt.Sprintf("Failed to connect after %d retries: %v", maxRetries, err))
    }

    err = db.AutoMigrate(&models.Seller{}, &models.Cart{}, &models.Inventory{}, &models.EachCartItem{}, &models.Orders{}, &models.Product{}, &models.User{})
    if err != nil {
        panic(fmt.Sprintf("Auto migration failed: %v", err))
    }
    DB = db
}

3. 验证容器间通信（排查用） #

如果以上修改后仍有问题，可进入后端容器测试连通性：

# 进入后端容器
docker exec -it backend sh
# 若为Alpine镜像，先安装ping工具
apk add iputils
# 测试db服务是否可达
ping db
# 用psql直接测试数据库连接
apk add postgresql-client
psql -h db -U postgres -d postgres

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