Golang中Gorm连接PostgreSQL报错，附Docker尝试求解决方案

问题分析 #

错误提示dial tcp 127.0.0.1:5432: connectex: No connection could be made because the target machine actively refused it.说明本地5432端口无服务监听，核心原因是Docker容器的PostgreSQL未正确暴露端口、代码配置与容器环境变量不匹配，同时代码逻辑存在小问题。

解决方案 #

1. 修正PostgreSQL Docker启动命令 #

你的启动命令存在两个关键错误：

• 未做端口映射：容器内PostgreSQL默认使用5432端口，但主机无法直接访问容器端口，需通过-p参数完成映射。
• 无效环境变量：POSTGRES_PORT不是PostgreSQL官方镜像的有效参数，容器内端口固定为5432，无需额外设置。

匹配代码配置的正确启动命令：

docker run -d --name film-frnxx -p 5432:5432 -e POSTGRES_PASSWORD=pass -e POSTGRES_USER=user -e POSTGRES_DB=db postgres

参数说明：

• -d：后台运行容器，避免占用终端
• -p 5432:5432：将主机5432端口映射到容器5432端口
• 环境变量与代码中的password、dbuser、dbname完全对应

2. 修正Golang代码逻辑 #

当前代码在数据库连接未确认成功时就执行AutoMigrate，会触发额外错误。需先判断连接状态，再执行迁移操作：

func DatabaseConnection() {
    host := "localhost"
    port := "5432"
    dbname := "db"
    dbuser := "user"
    password := "pass"
    dsn := fmt.Sprintf("host=%s port=%s user=%s dbname=%s password=%s sslmode=disable",
        host,
        port,
        dbuser,
        dbname,
        password,
    )
    DB, err = gorm.Open(postgres.Open(dsn), &gorm.Config{})
    // 先确认连接成功
    if err != nil {
        log.Fatal("Error connecting to the database...", err)
    }
    // 连接成功后执行表迁移
    err = DB.AutoMigrate(Film{})
    if err != nil {
        log.Fatal("Error migrating database schema...", err)
    }
    fmt.Println("Database connection successful...")
}

3. 验证容器运行状态 #

执行以下命令确认容器是否正常工作：

# 查看容器运行状态
docker ps
# 查看容器日志，确认PostgreSQL启动完成
docker logs film-frnxx

若容器未运行，执行docker start film-frnxx启动；若日志报错，根据提示排查容器配置问题。

4. Windows环境额外检查 #

如果是Windows系统，需确认5432端口未被本地程序（如本地安装的PostgreSQL）占用：

netstat -ano | findstr :5432

若有其他进程占用，关闭该进程或修改Docker映射端口（例如-p 5433:5432，同时将代码中的port改为5433）。

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