Docker部署Django连接PostgreSQL本地遇连接拒绝问题求助

核心问题分析 #

你的docker-compose.yml中仅定义了backend服务，未包含PostgreSQL数据库服务；同时.env中DATABASE_HOST=db是Docker服务名的写法，但不存在对应的db服务，导致连接失败。如果想用本地主机的PostgreSQL，容器内的localhost/127.0.0.1指向容器自身而非主机，这也是连接失败的关键原因。

方案一：用Docker启动PostgreSQL（推荐，与生产环境一致） #

1. 修改docker-compose.yml添加数据库服务 #

在配置中加入db服务，并让backend依赖该服务：

version: "3"
services:
  db:
    image: postgres:15  # 请选择与生产环境一致的PostgreSQL版本
    environment:
      POSTGRES_DB: ${DATABASE_NAME}
      POSTGRES_USER: ${DATABASE_USER}
      POSTGRES_PASSWORD: ${DATABASE_PASSWORD}
    volumes:
      - postgres_data:/var/lib/postgresql/data/  # 持久化数据库数据
    ports:
      - "5432:5432"  # 可选，方便本地客户端连接数据库

  backend:
    build:
      context: diabetesmelitusbackend
      args:
        - DATABASE_ENGINE=${DATABASE_ENGINE}
        - DATABASE_NAME=${DATABASE_NAME}
        - DATABASE_HOST=${DATABASE_HOST}
        - DATABASE_USER=${DATABASE_USER}
        - DATABASE_PASSWORD=${DATABASE_PASSWORD}
        - DATABASE_PORT=${DATABASE_PORT}
        - DJANGO_SUPERUSER_USERNAME=${DJANGO_SUPERUSER_USERNAME}
        - DJANGO_SUPERUSER_EMAIL=${DJANGO_SUPERUSER_EMAIL}
        - DJANGO_SUPERUSER_PASSWORD=${DJANGO_SUPERUSER_PASSWORD}
    image: backend
    ports:
      - "9000:9000"
    depends_on:
      - db  # 确保数据库服务先启动
    environment:
      - DATABASE_HOST=db  # 直接指定服务名，或保持.env中的配置

volumes:
  postgres_data:

2. 保持.env配置不变 #

你的.env中DATABASE_HOST=db无需修改，Docker内部网络会通过服务名解析到db容器的IP。

3. 重新启动服务 #

执行以下命令：

docker-compose down -v  # 清理旧的容器和数据卷（首次启动可选）
docker-compose up --build

方案二：使用本地主机已安装的PostgreSQL #

1. 修改.env中的数据库地址 #

将DATABASE_HOST改为host.docker.internal（Docker Desktop支持该主机名解析到本地主机），或你的主机实际局域网IP（比如192.168.1.100）：

DATABASE_HOST=host.docker.internal

2. 配置本地PostgreSQL允许容器连接 #

• 打开pg_hba.conf文件，添加以下规则（允许Docker默认桥接网络的IP段连接）：

  host    all             all             172.17.0.0/16            scram-sha-256
  

• 确保postgresql.conf中listen_addresses = '*'，允许所有IP访问。
• 重启本地PostgreSQL服务。

3. 验证本地数据库状态 #

确认PostgreSQL在5432端口正常运行，且没有被其他进程占用：

# macOS/Linux检查端口占用
lsof -i :5432
# Windows检查端口占用
netstat -ano | findstr :5432

额外排查点 #

• 检查Django的settings.py是否正确读取环境变量，确保数据库配置如下：

  import os
  
  DATABASES = {
      'default': {
          'ENGINE': os.environ.get('DATABASE_ENGINE'),
          'NAME': os.environ.get('DATABASE_NAME'),
          'USER': os.environ.get('DATABASE_USER'),
          'PASSWORD': os.environ.get('DATABASE_PASSWORD'),
          'HOST': os.environ.get('DATABASE_HOST'),
          'PORT': os.environ.get('DATABASE_PORT'),
      }
  }
  

• 如果使用Docker的PostgreSQL服务，首次启动时需要等待数据库初始化完成再执行Django的migrate操作，可以在启动脚本中加入连接重试逻辑，或使用wait-for-it工具等待数据库就绪。

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