如何在Docker/Docker Compose中自动创建PostgreSQL表？

错误原因分析 #

• Dockerfile的RUN指令报错：RUN是镜像构建阶段的指令，此时Postgres服务并未启动，也没有初始化数据库实例，执行脚本自然找不到数据库相关资源。
• docker-compose的command字段报错：直接用command替换默认启动命令后，容器会先执行你的init.sh脚本，但此时Postgres服务还未启动，导致数据库连接失败。

Postgres官方镜像本身提供了自动初始化的机制，不需要手动通过RUN或command执行脚本，正确做法是利用镜像的/docker-entrypoint-initdb.d/目录——容器第一次启动（数据目录为空时），会自动执行该目录下的.sh、.sql、.sql.gz文件，且会等待数据库服务就绪后再执行。

方法1：通过Dockerfile配置 #

将你的初始化脚本和SQL文件复制到镜像的/docker-entrypoint-initdb.d/目录，并赋予脚本可执行权限：

FROM postgres:latest
# 复制初始化脚本和SQL文件到指定目录
COPY init.sh /docker-entrypoint-initdb.d/
COPY schemas.sql /docker-entrypoint-initdb.d/
# 赋予脚本执行权限
RUN chmod +x /docker-entrypoint-initdb.d/init.sh

构建镜像后启动容器，第一次启动时会自动执行init.sh和schemas.sql完成表创建。

方法2：通过docker-compose挂载卷配置 #

无需修改Dockerfile，直接将本地的初始化脚本目录挂载到容器的/docker-entrypoint-initdb.d/：

1. 本地创建init-scripts目录，将init.sh和schemas.sql放入其中，先给脚本加执行权限：

chmod +x init-scripts/init.sh

2. 编写docker-compose.yml：

version: '3.8'
services:
  postgres:
    image: postgres:latest
    environment:
      # 根据你的需求设置环境变量
      POSTGRES_USER: myuser
      POSTGRES_PASSWORD: mypassword
      POSTGRES_DB: mydb
    volumes:
      # 挂载本地初始化脚本目录到容器指定路径
      - ./init-scripts:/docker-entrypoint-initdb.d/
      # 挂载数据卷保存数据库数据，避免容器删除后数据丢失
      - postgres-data:/var/lib/postgresql/data
volumes:
  postgres-data:

启动容器时，第一次初始化会自动执行目录内的脚本。

注意事项 #

• 初始化脚本仅在第一次启动容器（数据卷为空）时执行，如果已经有现有数据卷，需先删除数据卷（docker-compose down -v）再重新启动才会触发。
• init.sh中建议使用环境变量（如$POSTGRES_USER、$POSTGRES_DB）代替硬编码的连接参数，避免和配置的环境变量不一致。
• 若脚本中有自定义数据库操作，可添加就绪检查确保数据库可用：

#!/bin/bash
set -e

# 等待Postgres服务就绪
until pg_isready -U "$POSTGRES_USER" -d "$POSTGRES_DB"; do
  echo "等待PostgreSQL启动..."
  sleep 2
done

# 执行建表SQL
psql -U "$POSTGRES_USER" -d "$POSTGRES_DB" -f /docker-entrypoint-initdb.d/schemas.sql

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