构建Docker容器时PostgreSQL连接失败问题求助

Docker的RUN指令是在镜像构建阶段执行的，每个RUN步骤都会创建一个临时容器，执行完指令后容器就会被销毁，服务不会在多个RUN层之间保持运行。你之前分开启动PostgreSQL和执行迁移的写法，两个步骤在不同的临时容器中，执行迁移时PostgreSQL根本没运行，自然会报连接拒绝。

以下两种方案任选其一：

方案1：在单个RUN指令中完成服务启动、迁移、停止 #

把PostgreSQL启动、等待就绪、执行迁移、停止服务的命令放在同一个RUN里，确保它们在同一个临时容器中执行：

# 假设你的基础镜像已包含PostgreSQL和Python环境
# ... 前面安装依赖、创建数据库用户/库的步骤 ...

RUN service postgresql start && \
    # 等待PostgreSQL服务完全就绪（避免连接过早失败）
    until pg_isready -U postgres; do sleep 1; done && \
    # 执行Django迁移
    python manage.py makemigrations && \
    python manage.py migrate && \
    # 停止PostgreSQL服务（构建阶段不需要保持运行）
    service postgresql stop

如果数据库用户和库还未创建，需把创建命令加入这个RUN块：

su - postgres -c "createuser -s django_user" && \
su - postgres -c "createdb -O django_user django_db" && \

方案2：将迁移放到容器启动时执行（更推荐） #

构建阶段只做环境准备，把服务启动和迁移逻辑放到容器启动时的入口脚本中，更符合容器运行的最佳实践：

1. 编写入口脚本entrypoint.sh：

#!/bin/bash
set -e

# 启动PostgreSQL服务
service postgresql start

# 等待数据库就绪
until pg_isready -U postgres; do
    echo "等待PostgreSQL启动..."
    sleep 1
done

# 确保数据库用户和库存在（避免构建阶段遗漏）
su - postgres -c "createuser -s --if-not-exists django_user"
su - postgres -c "createdb -O django_user --if-not-exists django_db"

# 执行Django迁移
python manage.py makemigrations
python manage.py migrate

# 启动Django服务
exec python manage.py runserver 0.0.0.0:8000

2. 在Dockerfile中添加以下内容：

# ... 前面安装依赖、复制项目文件的步骤 ...

COPY entrypoint.sh /usr/local/bin/
RUN chmod +x /usr/local/bin/entrypoint.sh
ENTRYPOINT ["entrypoint.sh"]

• 必须用pg_isready或类似命令等待PostgreSQL完全启动，直接启动后立刻执行迁移会因数据库未初始化完成而失败。
• 若Django数据库配置中HOST设为localhost或127.0.0.1，这个配置是正确的，因为PostgreSQL和Django在同一个容器中。

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