Docker容器执行PostgreSQL恢复脚本启动报错：套接字连接失败

问题根源 #

你通过command: scrip_psql.sh覆盖了PostgreSQL镜像的默认启动命令——官方镜像默认会先启动PostgreSQL服务进程，替换成自定义脚本后，脚本直接执行psql命令，但此时数据库还没完成初始化启动，自然连不上本地socket。而手动进入容器时，数据库已经完全启动，所以脚本能正常运行。

解决方案 #

方案1：让脚本等待数据库就绪后再执行

修改你的scrip_psql.sh，在核心恢复逻辑前增加等待数据库服务就绪的判断：

#!/bin/bash
# 等待PostgreSQL服务可用
until pg_isready -U postgres; do
  echo "等待PostgreSQL服务启动..."
  sleep 2
done

# 执行你的下载和恢复操作
# 示例：
# wget -O backup.sql https://your-backup-path/backup.sql
# psql -U postgres -d target_db -f backup.sql

确保脚本有可执行权限（本地执行chmod +x scrip_psql.sh），Docker Compose中保持command: ./scrip_psql.sh，同时注意脚本在容器内的路径是否正确（可通过挂载或镜像构建时COPY进去）。

方案2：利用官方镜像的初始化脚本机制

PostgreSQL官方镜像会自动执行/docker-entrypoint-initdb.d/目录下的脚本，且是在数据库首次初始化完成后执行。这种方式适合首次启动容器时执行一次恢复的场景：

services:
  postgres-backup:
    image: postgres:latest
    volumes:
      - ./scrip_psql.sh:/docker-entrypoint-initdb.d/scrip_psql.sh
      - postgres-data:/var/lib/postgresql/data
    environment:
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: your_pwd
      POSTGRES_DB: your_target_db
    # 无需设置command，使用默认启动逻辑
volumes:
  postgres-data:

注意：此脚本仅在数据卷为空（首次初始化数据库）时执行，若需要每次启动容器都执行恢复，优先选方案1。

方案3：自定义复合启动脚本

如果需要每次启动容器都执行恢复，且保持PostgreSQL服务前台运行（避免容器退出），可以写一个复合脚本：

#!/bin/bash
# 后台启动PostgreSQL服务
postgres -D /var/lib/postgresql/data &
PG_PROCESS=$!

# 等待服务就绪
until pg_isready -U postgres; do
  echo "等待PostgreSQL启动..."
  sleep 2
done

# 执行下载和恢复逻辑
# 你的命令...

# 等待PostgreSQL进程，维持容器运行
wait $PG_PROCESS

Docker Compose中设置command: ./custom-start.sh，同样要确保脚本有可执行权限。

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