Golang后端Docker Compose部署时无法连接PostgreSQL数据库求助

我的Golang后端本地连接PostgreSQL数据库一切正常，但通过docker-compose运行时无法连接数据库。修改.env中的连接字符串后问题仍未解决，请求排查。

docker-compose配置 #

version: '3.8'

services:
  app:
    build: .
    ports:
      # - "8080:8080"
      - "${PORT}:${PORT}"
    depends_on:
      - db
    environment:
      - DB_CONN=postgres://postgres:password@db:5432/tutor-connect
      # - PORT=8080
      - PORT=${PORT}

    volumes:
      - ./cmd:/app/cmd
      - ./config:/app/config
      - ./internal:/app/internal
      - ./go.mod:/app/go.mod
      - ./go.sum:/app/go.sum
      - ./README.md:/app/README.md
    env_file:
      - .env

  db:
    image: postgres:16.2
    environment:
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: password
      POSTGRES_DB: tutor-connect
    ports:
      - "5433:5432"
    volumes:
      # - /docker-entrypoint-initdb.d:/docker-entrypoint-initdb.d
      - postgres_data:/var/lib/postgresql/data

volumes:
  postgres_data:

报错日志 #

tutor-backend-app-1  | DB STRING :  postgres://postgres:password@db:5432/tutor-connect
tutor-backend-app-1  | db string is : postgres://postgres:password@db:5432/tutor-connect
tutor-backend-app-1  | 
tutor-backend-app-1  | 2024/06/11 06:39:25 /app/internal/adapters/db/db.go:15
tutor-backend-app-1  | [error] failed to initialize database, got error failed to connect to `host=db user=postgres database=tutor-connect`: hostname resolving error (lookup db on 127.0.0.11:53: server misbehaving)
tutor-backend-app-1  | Error connecting to DB failed to connect to `host=db user=postgres database=tutor-connect`: hostname resolving error (lookup db on 127.0.0.11:53: server misbehaving)
tutor-backend-app-1  | 2024/06/11 06:39:25 Can't connect to database
tutor-backend-db-1 exited with code 1
tutor-backend-app-1 exited with code 1

数据库连接代码 #

err := godotenv.Load(".env")
dbString := os.Getenv("DB_CONN")
var dsn = flag.String("dsn", dbString, "Connection string to database")

从报错来看，核心问题是数据库容器tutor-backend-db-1启动失败（退出码1），导致app容器无法解析db主机名。按以下步骤排查：

1. 查看数据库容器启动日志
   执行命令docker logs tutor-backend-db-1，获取数据库容器的具体报错信息，常见原因包括：

   • 挂载的postgres_data卷存在旧数据，与当前配置的用户/数据库冲突
   • 容器文件权限异常，导致PostgreSQL无法初始化数据目录

2. 重置数据库卷
   如果是旧卷数据冲突，执行docker-compose down -v删除所有关联卷，再重新启动：docker-compose up --build。此操作会清除数据库旧数据，测试时可用。

3. 调整app启动时机
   depends_on仅保证db容器先启动，不保证数据库服务就绪。需要在app中添加重试逻辑：

   // 在数据库连接代码中添加循环重试
   var db *gorm.DB
   var err error
   maxRetries := 5
   for i := 0; i < maxRetries; i++ {
       db, err = gorm.Open(postgres.Open(*dsn), &gorm.Config{})
       if err == nil {
           break
       }
       log.Printf("Failed to connect to DB, retrying... (%d/%d)", i+1, maxRetries)
       time.Sleep(2 * time.Second)
   }
   if err != nil {
       log.Fatalf("Can't connect to database after %d retries: %v", maxRetries, err)
   }
   

4. 确认环境变量优先级
   docker-compose中environment字段的变量会覆盖env_file中的值，当前DB_CONN已在environment中配置正确，无需在.env中重复设置，避免变量冲突。

5. 检查Docker网络
   默认docker-compose会创建专属网络，执行docker network ls找到项目对应的网络，再用docker network inspect <网络名称>确认app和db容器都在该网络内。

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