使用docker-compose时如何检测postgresql服务是否已正常启动

方法1：在docker-compose中配置内置健康检查（最推荐） #

PostgreSQL官方镜像自带pg_isready检测工具，你可以直接在compose配置中给postgresql服务添加健康检查规则，Docker会自动判断服务是否可用：

version: "3.7"
services:
  postgresql:
    image: "postgres:13-alpine"
    restart: always
    volumes:
      - type: bind
        source: ./DO_NOT_DELETE_postgres_data
        target: /var/lib/postgresql/data
    environment:
      POSTGRES_DB: test
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: abc123
      PGDATA: "/var/lib/postgresql/data/pgdata"
    networks:
      - postgresql_network
    # 新增健康检查配置
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres"]
      interval: 5s
      timeout: 5s
      retries: 5

  otherservice:
    # 若需要otherservice等postgresql就绪后再启动，新增以下依赖配置
    depends_on:
      postgresql:
        condition: service_healthy
    .... (此处还有其他若干服务)

networks:
  postgresql_network:
    driver: bridge

配置完成后重新启动服务，即可通过容器状态直接判断PostgreSQL是否就绪。

方法2：宿主机侧手动检测 #

• 查看容器健康状态：执行docker compose ps postgresql，STATUS列显示healthy就表示服务正常就绪
• 手动执行检测命令：执行docker compose exec postgresql pg_isready -U postgres，输出/var/run/postgresql:5432 - accepting connections即为就绪

方法3：从otherservice内部检测 #

若服务内安装了PostgreSQL客户端工具 #

优先使用官方检测工具：

pg_isready -h postgresql -U postgres

命令返回状态码0就表示服务可正常连接。
也可以直接执行测试SQL验证服务可用性：

PGPASSWORD=abc123 psql -h postgresql -U postgres -d test -c "SELECT 1;"

成功返回1的查询结果就说明数据库可以正常处理请求。

若服务内未安装PostgreSQL客户端工具 #

可以用netcat检测端口连通性：

nc -zv postgresql 5432

返回连接成功说明网络和端口正常，注意该方法仅能验证端口可达，无法验证数据库服务本身是否完成初始化可以处理请求。

如果需要在otherservice的启动脚本中自动等待PostgreSQL就绪，可以加入以下循环逻辑：

until pg_isready -h postgresql -U postgres; do
  echo "等待PostgreSQL启动..."
  sleep 2
done
echo "PostgreSQL已就绪，可以执行操作"

注意：你给出的示例操作命令存在参数错误，psql的-p参数是指定连接端口的配置，不能直接填写密码，密码可以通过PGPASSWORD环境变量传递，或者执行命令后手动输入。

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