Django项目Docker镜像运行时无法连接本地PostgreSQL报错

• 核心原因是Docker默认的网络隔离机制：容器内部的localhost/127.0.0.1指向容器自身的网络命名空间，和宿主机的本地网络不是同一个环境。你当前Django配置中连接的localhost:5432实际是在找容器内部运行的PostgreSQL服务，但容器内并没有部署该服务，因此直接抛出连接拒绝错误。
• 你的Dockerfile存在潜在配置问题：基础镜像使用的是Debian系的python:3.8.10，但被注释的系统依赖安装命令是Alpine发行版的apk指令，即使取消注释也无法正常执行；而psycopg2连接PostgreSQL必须依赖对应的系统开发库，缺失的话后续即使网络连通也会出现依赖报错。

按以下顺序操作即可修复问题：

1. 修改Django数据库连接配置
   打开项目的settings.py找到DATABASES配置段，根据你运行Docker的操作系统替换HOST取值：
   • Linux系统：将HOST从localhost改为Docker网桥默认的宿主机地址172.17.0.1
   • Windows/macOS系统（使用Docker Desktop）：将HOST改为Docker内置的宿主机解析域名host.docker.internal
   • 如果你启动容器时添加--network="host"参数（仅Linux下原生Docker完全支持），容器会直接复用宿主机网络栈，此时可以保留localhost作为HOST值
2. 配置宿主机PostgreSQL允许容器网段访问
   • 找到宿主机PostgreSQL的pg_hba.conf文件，新增一行访问规则：host all all 172.17.0.0/16 md5，允许Docker网桥网段的IP连接数据库
   • 打开宿主机PostgreSQL的postgresql.conf文件，将listen_addresses配置从默认的127.0.0.1改为*，保存后重启宿主机的PostgreSQL服务
3. 修复Dockerfile的依赖安装逻辑
   删掉原来注释的Alpine版apk安装命令，替换为适配Debian基础镜像的依赖安装指令：

RUN apt-get update && apt-get install -y --no-install-recommends \
    build-essential \
    postgresql-server-dev-all \
    libpcre3-dev \
    curl \
    bash \
    nginx \
    libssl-dev \
    libffi-dev \
    && rm -rf /var/lib/apt/lists/*

这段命令会安装psycopg2编译运行必须的系统依赖，同时清理apt缓存减小镜像体积。
4. 重新构建镜像并启动

• 在项目根目录执行构建命令：docker build -t ds-process-api .
• 启动容器时如果没有使用host网络模式，需要添加端口映射参数：docker run -d -p 8020:8020 ds-process-api

更推荐的实践方案：不要连接宿主机的PostgreSQL，而是将PostgreSQL也作为容器部署，将两个服务加入同一个自定义Docker网络，直接通过PostgreSQL容器的服务名做内部连接，不需要修改宿主机数据库配置，隔离性和稳定性更好。

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