如何解决GitLab CI/CD流水线中psql命令无法连接PostgreSQL的问题

你遇到的psql连接报错根本原因是：GitLab CI中配置的postgres:12.2-alpine是独立运行的sidecar服务容器，和你的CI任务容器不属于同一个环境，默认psql会尝试连接本地Unix套接字，自然找不到服务。以下是完整修正方案：

在variables段新增PostgreSQL服务地址相关配置，GitLab CI会自动将服务容器的地址映射为postgres主机名：

variables:
  # 原有变量保持不变，新增以下两个变量
  POSTGRES_HOST: postgres
  PGHOST: postgres

配置PGHOST后psql会默认连接到PostgreSQL服务容器，无需每次执行命令手动指定host。

原逻辑存在两个问题：一是安装了不必要的PostgreSQL服务端，二是psql参数使用错误（-d是指定数据库名，执行SQL语句需用-c参数），修正后的代码如下：

unit_test:
  stage: unit_test
  script:
    - echo "Running unit_test 1"
    - pytest ./my_app/unit_test.py
    - echo "Creating db"
    # 仅需安装客户端和开发依赖，无需安装服务端
    - apt-get install -y --no-install-recommends postgresql-client libpq-dev
    # 用默认管理员账号连接服务执行初始化SQL，密码加单引号避免语法错误
    - psql -U postgres -c "CREATE USER $POSTGRES_USER WITH PASSWORD '$POSTGRES_PASSWORD' CREATEDB;"
    - psql -U postgres -c "CREATE DATABASE $POSTGRES_DB OWNER $POSTGRES_USER;"
    - echo "Unit testing stage finished"

你配置中用到的$POSTGRES_DB、$POSTGRES_USER、$POSTGRES_PASSWORD需要提前在GitLab项目的「设置」-「CI/CD」-「变量」中添加对应值，避免执行时变量为空导致SQL语法错误。

如果需要在多个阶段用到PostgreSQL客户端，可以把postgresql-client的安装逻辑移到before_script中，避免重复安装。

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