Docker-Compose中Golang应用连接PostgreSQL时出现连接拒绝问题

你的核心问题是Go应用启动时，PostgreSQL容器虽已启动，但服务尚未完全就绪，导致连接被拒绝。depends_on仅能保证容器启动顺序，无法确保数据库服务可用。以下是几种可行的解决方法：

方法一：给Go应用添加数据库连接重试机制 #

在数据库初始化代码中加入循环重试逻辑，直到连接成功或达到最大重试次数。示例代码：

package db

import (
	"time"

	"gorm.io/driver/postgres"
	"gorm.io/gorm"
)

func InitDB(dbURL string) (*gorm.DB, error) {
	var db *gorm.DB
	var err error
	maxRetries := 10
	retryDelay := 2 * time.Second

	for i := 0; i < maxRetries; i++ {
		db, err = gorm.Open(postgres.Open(dbURL), &gorm.Config{})
		if err != nil {
			time.Sleep(retryDelay)
			continue
		}
		// 验证连接有效性
		sqlDB, _ := db.DB()
		if pingErr := sqlDB.Ping(); pingErr == nil {
			return db, nil
		}
		time.Sleep(retryDelay)
	}
	return nil, err
}

方法二：使用Docker Compose健康检查控制启动顺序 #

通过给PostgreSQL服务添加健康检查，让Go应用等待数据库服务就绪后再启动：

1. 修改docker-compose.yml中的db服务，添加健康检查配置：

db:
  container_name: dborder
  image: postgres:14-alpine
  restart: always
  hostname: dborder
  environment:
    POSTGRES_USER: dev
    POSTGRES_PASSWORD: passwordqwerty
    POSTGRES_DB: orderdb
  ports:
    - "5432:5432"
  networks:
    - mynet
  healthcheck:
    test: ["CMD-SHELL", "pg_isready -U dev -d orderdb"]
    interval: 5s
    timeout: 5s
    retries: 5

2. 修改web服务的depends_on，指定等待db服务健康：

depends_on:
  db:
    condition: service_healthy

额外排查步骤 #

• 执行docker logs dborder查看PostgreSQL容器日志，确认数据库是否正常初始化，有无权限、端口冲突等错误。
• 确认Go应用的数据库连接URL中的用户名、密码、数据库名与PostgreSQL容器环境变量完全一致。

内容的提问来源于stack exchange，提问作者Nathan Garcia dos Santos