Docker Compose部署Django+PostgreSQL连接失败求助

问题现象 #

执行docker compose up -d后，PostgreSQL容器日志显示服务已就绪：

2023-02-18 00:10:25.049 UTC [1] LOG:  starting PostgreSQL 13.8 on aarch64-unknown-linux-musl, compiled by gcc (Alpine 11.2.1_git20220219) 11.2.1 20220219, 64-bit
2023-02-18 00:10:25.049 UTC [1] LOG:  listening on IPv4 address "0.0.0.0", port 5432
2023-02-18 00:10:25.049 UTC [1] LOG:  listening on IPv6 address "::", port 5432
2023-02-18 00:10:25.052 UTC [1] LOG:  listening on Unix socket "/var/run/postgresql/.s.PGSQL.5432"
2023-02-18 00:10:25.054 UTC [22] LOG:  database system was shut down at 2023-02-18 00:10:06 UTC
2023-02-18 00:10:25.056 UTC [1] LOG:  database system is ready to accept connections

但Django容器日志报连接拒绝错误：

django.db.utils.OperationalError: could not connect to server: Connection refused
Is the server running on host "127.0.0.1" and accepting
TCP/IP connections on port 5432?

现有配置 #

docker-compose.yml #

version: '3.8'
services:
  web:
    build: .
    command: sh -c "python manage.py runserver 0.0.0.0:8000"
    volumes:
      - .:/code
    ports:
      - "8000:8000"
    env_file:
      - ./xi/.env
    depends_on:
      - db
  db:
    image: postgres:13-alpine
    environment:
      - POSTGRES_DB=***
      - POSTGRES_USER=***
      - POSTGRES_PASSWORD=***
    volumes:
      - dev-db-data:/var/lib/postgresql/data
    ports:
      - 5432:5432
volumes:
  dev-db-data:

Dockerfile #

FROM python:3.8
ENV PYTHONDONTWRITEBYTECODE=1
ENV PYTHONUNBUFFERED=1
WORKDIR /code

# install psycopg2 dependencies
RUN apt-get update
RUN apt-get install nano python3-dev libpq-dev -y

COPY requirements-prod.txt /code/
RUN pip install -r requirements.txt
COPY . /code/

核心问题解决 #

你遇到的核心问题是Django容器的数据库连接目标错误：在Docker Compose的默认网络中，每个容器都是独立的网络节点，127.0.0.1指向容器自身，而非PostgreSQL容器。

修复步骤 #

1. 修改Django数据库配置：
   在settings.py（或对应的环境变量）中，将数据库主机从127.0.0.1改为db——即docker-compose.yml里PostgreSQL服务的名称，Docker会自动解析这个名称到对应的容器IP：

   DATABASES = {
       'default': {
           'ENGINE': 'django.db.backends.postgresql',
           'NAME': os.environ.get('POSTGRES_DB'),
           'USER': os.environ.get('POSTGRES_USER'),
           'PASSWORD': os.environ.get('POSTGRES_PASSWORD'),
           'HOST': 'db',  # 替换原有的127.0.0.1
           'PORT': '5432',
       }
   }
   

2. 处理数据库就绪延迟：
   depends_on仅保证容器启动顺序，不保证PostgreSQL完全就绪。可以添加等待脚本确保数据库可用：

   • 下载wait-for-it.sh到项目根目录
   • 修改web服务的启动命令：

     command: sh -c "./wait-for-it.sh db:5432 -- python manage.py runserver 0.0.0.0:8000"
     

额外问题解答 #

1. "listening on IPv4 address '0.0.0.0', port 5432"的含义 #

你的理解正确，0.0.0.0表示PostgreSQL监听容器所有可用的网络接口（包括Docker分配的容器IP），这不会导致连接问题，问题根源是Django的连接目标错误。

2. Docker容器高效调试方法 #

• 进入容器交互式排查：执行docker exec -it <web容器名/ID> bash进入容器，直接运行python manage.py shell测试数据库连接，或用psql -h db -U <用户名> <数据库名>验证网络连通性。
• 检查环境变量：在容器内执行env，确认Django读取的数据库配置环境变量是否符合预期。
• 替换启动命令为交互式Shell：暂时将web服务的command改为bash，启动容器后手动执行启动命令，逐步排查问题。
• 查看容器网络信息：用docker inspect <db容器ID>获取PostgreSQL容器的IP，在web容器内用ping <IP>或telnet <IP> 5432测试网络连通性。
• 挂载本地配置实时测试：利用volumes挂载本地settings.py，修改后无需重新构建镜像，直接重启容器即可验证配置。

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