Azure Pipeline中Docker容器PostGIS geometry类型创建失败问题排查

核心原因 #

本地Windows环境中容器启动后有足够时间让PostgreSQL完成初始化，但Azure Pipeline的Ubuntu环境里，SQL脚本可能在PostgreSQL服务未完全就绪、PostGIS扩展未成功创建的情况下就开始执行，导致找不到postgis.geometry类型。

具体解决方案 #

1. 等待PostgreSQL服务完全就绪 #

在Azure Pipeline的脚本步骤中添加等待逻辑，确保PostgreSQL容器启动完成后再执行SQL脚本。可以用pg_isready命令实现：

# 最多等待30秒，直到PostgreSQL就绪
until docker exec -it <你的postgres容器名/ID> pg_isready -U my_account -d <你的数据库名>; do
  sleep 2
done

或者安装wait-for-it工具进行等待：

apt-get update && apt-get install -y wait-for-it
wait-for-it localhost:5432 -t 30 -- echo "PostgreSQL已就绪"

2. 调整SQL脚本，确保扩展创建生效 #

修改SQL脚本，明确扩展创建逻辑并确保搜索路径生效：

-- 创建schema并设置全局搜索路径
create schema if not exists postgis;
set search_path = postgis, public;

-- 强制创建PostGIS扩展（若未创建则报错，避免静默失败）
create extension postgis schema postgis;

-- 授予权限（若my_account为超级用户可省略）
GRANT ALL PRIVILEGES ON SCHEMA postgis TO my_account;

-- 创建表，因搜索路径已包含postgis，可直接使用geometry类型
create table if not exists location
(
    id integer not null,
    geometry geometry
);

alter table location owner to my_account;

如果必须用schema限定类型，可先查询确认扩展所在schema：

SELECT extname, nspname FROM pg_extension WHERE extname = 'postgis';

确认返回的nspname为postgis后，再执行建表语句。

3. 为Docker容器添加健康检查 #

在docker-compose.yml中添加健康检查配置，让Pipeline等待容器进入健康状态后再执行脚本：

version: "3.8"

services:
  postgres:
    image: postgis/postgis:14-3.3-alpine
    environment:
      - POSTGRES_USER=my_account
      - POSTGRES_PASSWORD=**
      - POSTGRES_DB=**
    ports:
      - "5432:5432"
    networks:
      - local
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U my_account -d <你的数据库名>"]
      interval: 5s
      timeout: 5s
      retries: 5

然后在Pipeline中执行：

docker-compose up -d
docker-compose wait postgres

等待健康检查通过后再运行SQL脚本。

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