在GitLab CI中配置PostGIS失败：psql无法连接服务器

这个报错通常由几个常见原因导致，我来帮你逐个排查：

1. PostgreSQL服务尚未完全就绪就执行了psql命令 #

GitLab CI启动服务容器后，不会等待数据库服务完成初始化就直接运行测试脚本。这时候你执行psql命令时，PostgreSQL还没完成启动流程，自然会出现连接失败的情况。

解决方案：
在执行psql命令前，添加一段等待服务就绪的检测逻辑。可以用循环检测的方式：

# 循环等待PostgreSQL服务可用
until psql -h "postgres" -U "$POSTGRES_USER" -d "$POSTGRES_DB" -c '\q'; do
  >&2 echo "PostgreSQL is unavailable - sleeping"
  sleep 2
done

>&2 echo "PostgreSQL is up - executing command"
psql -h "postgres" -U "$POSTGRES_USER" -d "$POSTGRES_DB" -c "CREATE EXTENSION \"postgis\";"

如果你的测试镜像里没有psql，也可以用nc（netcat）检测端口连通性：

until nc -z postgres 5432; do
  >&2 echo "PostgreSQL is unavailable - sleeping"
  sleep 2
done

2. 测试镜像中未安装PostgreSQL客户端 #

你的测试任务使用$IMAGE:latest作为运行镜像，如果这个镜像里没有安装psql客户端，即使你指定了主机参数，也可能因为psql默认尝试连接本地Unix套接字（而该套接字不存在），导致出现“找不到服务器”的报错。

解决方案：
在你的Dockerfile.prod中添加安装PostgreSQL客户端的步骤：

• 若镜像基于Debian/Ubuntu：

RUN apt-get update && apt-get install -y --no-install-recommends postgresql-client && rm -rf /var/lib/apt/lists/*

• 若镜像基于Alpine：

RUN apk add --no-cache postgresql-client

3. 额外提示：PostGIS镜像默认已预装PostGIS扩展 #

其实postgis/postgis:latest镜像在初始化时，已经为默认模板数据库安装了PostGIS扩展。你创建的users数据库默认会继承模板库的扩展，所以你可以先跳过CREATE EXTENSION命令，直接运行测试看看是否能正常使用。

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