如何通过Docker Compose自动在PostgreSQL容器中执行psql命令？

嘿，这个问题我之前踩过一模一样的坑！先给你把原因说透：你用RUN psql ...的Dockerfile之所以失败，核心是**RUN指令是在镜像构建阶段执行的**——这时候PostgreSQL的服务进程根本没启动！镜像构建只是把文件、指令打包成镜像，容器还没运行，数据库服务自然没起来，psql连不上是必然的。

下面给你两种用Docker Compose实现自动化执行psql命令的方案，覆盖不同场景：

PostgreSQL官方镜像自带了一个贴心的特性：只要把.sql、.sh这类初始化脚本放到容器的/docker-entrypoint-initdb.d/目录下，容器第一次启动且数据目录为空时，会自动启动PostgreSQL服务，然后按顺序执行这些脚本。结合Docker Compose的话，步骤超简单：

1. 先写好你的初始化脚本，比如init.sql：

CREATE USER myappuser WITH PASSWORD 'mysecurepass';
CREATE DATABASE myappdb OWNER myappuser;
GRANT ALL PRIVILEGES ON DATABASE myappdb TO myappuser;

2. 编写Docker Compose配置文件（docker-compose.yml），把脚本挂载到指定目录，同时配置必要的环境变量和数据持久化：

version: '3.8'
services:
  postgres:
    image: postgres:15  # 可以换成你需要的版本
    environment:
      - POSTGRES_PASSWORD=rootpass  # 默认超级用户postgres的密码
    volumes:
      - ./init.sql:/docker-entrypoint-initdb.d/init.sql  # 挂载初始化脚本
      - postgres_data:/var/lib/postgresql/data  # 持久化数据，避免每次重启都重新初始化
    ports:
      - "5432:5432"

volumes:
  postgres_data:

启动容器后，第一次运行时会自动执行init.sql里的所有命令，完全不需要手动操作。而且因为挂载了数据卷，后续重启容器只会用已有的数据库数据，不会重复执行初始化脚本。

如果是容器已经运行起来后，需要自动化执行一些psql命令（比如新增表、修改配置），可以借助Compose的服务依赖和健康检查来确保命令在PostgreSQL就绪后执行：

version: '3.8'
services:
  postgres:
    image: postgres:15
    environment:
      - POSTGRES_PASSWORD=rootpass
    volumes:
      - postgres_data:/var/lib/postgresql/data
    ports:
      - "5432:5432"
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres"]
      interval: 5s
      timeout: 5s
      retries: 5  # 多次检查确保服务真的就绪

  run_psql_command:
    image: postgres:15
    depends_on:
      postgres:
        condition: service_healthy  # 等postgres健康检查通过再执行
    environment:
      - PGPASSWORD=rootpass  # 用环境变量传递密码，避免交互输入
    command: psql -h postgres -U postgres -c "CREATE TABLE test_table (id SERIAL PRIMARY KEY, content TEXT);"
volumes:
  postgres_data:

执行docker-compose up run_psql_command后，这个临时服务会等待PostgreSQL就绪，然后执行指定的psql命令，执行完成后自动退出。

额外小贴士： #

• 如果你想自定义镜像，还是用你之前成功的方式：把脚本COPY到/docker-entrypoint-initdb.d/，然后在Compose里用这个自定义镜像就行，别用RUN执行psql！
• 可以用POSTGRES_USER环境变量修改默认超级用户名，不用局限于postgres，脚本里对应调整即可。
• 密码尽量用环境变量传递，别在命令行里明文写，避免泄露风险。

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