在Docker中配置GDAL支持Flask后端服务遇错求助

问题描述 #

我尝试在Docker中配置GDAL，用于支持基于Flask的Python后端Web服务器，执行docker compose up -d后出现以下错误：

Could not find gdal-config. Make sure you have installed the GDAL native library and development headers.

我曾参考Django在Docker中配置GDAL的方案，使用Alpine镜像执行以下命令，但未解决错误：

RUN apk --no-cache add ca-certificates tzdata
RUN apk add --no-cache –repository 
http://dl-cdn.alpinelinux.org/alpine/edge/testing gdal

当前我的Dockerfile配置：

FROM python:3.10-alpine

COPY requirements.txt /
RUN pip install -r requirements.txt

COPY app /app/

ENV FLASK_APP=/app
ENV FLASK_RUN_HOST=0.0.0.0
ENV FLASK_DEBUG=0

CMD ["gunicorn", "-b", "0.0.0.0:1111", "app:app"]

docker-compose配置：

services:
   backend:
      build:
         context: ./backend
         dockerfile: Dockerfile
      ports:
          - '1111:1111'

问题根源 #

仅安装gdal包只能获得运行时库，缺少开发头文件和gdal-config工具，而Python的GDAL绑定（如GDAL或pygdal）在安装时必须调用gdal-config来获取编译参数，这就是报错的核心原因。

修正方案 #

调整Dockerfile配置 #

修改后的Dockerfile需要先安装GDAL开发包及编译工具链，再安装Python依赖，确保gdal-config在pip安装前已存在：

FROM python:3.10-alpine

# 添加上edge/testing仓库到镜像源列表
RUN echo "http://dl-cdn.alpinelinux.org/alpine/edge/testing" >> /etc/apk/repositories

# 安装GDAL运行时、开发包及编译依赖
RUN apk --no-cache add \
    ca-certificates \
    tzdata \
    gdal \
    gdal-dev \
    gcc \
    musl-dev \
    python3-dev

# 复制并安装Python依赖（此时gdal-config已可用）
COPY requirements.txt /
RUN pip install -r requirements.txt

COPY app /app/

ENV FLASK_APP=/app
ENV FLASK_RUN_HOST=0.0.0.0
ENV FLASK_DEBUG=0

CMD ["gunicorn", "-b", "0.0.0.0:1111", "app:app"]

关键说明 #

• gdal-dev：包含gdal-config工具和编译所需的头文件，是Python GDAL绑定安装的核心依赖
• gcc、musl-dev、python3-dev：Alpine镜像默认没有这些编译工具链，缺少它们会导致Python原生扩展编译失败
• 仓库配置：直接写入/etc/apk/repositories比单次命令指定--repository更稳定，后续所有apk命令都能访问该仓库
• 版本匹配：确保requirements.txt中GDAL的版本与系统安装的GDAL版本尽量一致，避免版本不兼容问题

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