Docker部署Django时GDAL安装失败：VSIDIR类型未定义错误求助

我之前在Docker环境下部署依赖GDAL的Django应用时，也碰到过几乎一模一样的错误，分享几个亲测有效的解决步骤：

1. 修复环境变量的持久化问题 #

你当前的RUN export CPLUS_INCLUDE_PATH...和RUN export C_INCLUDE_PATH...不会在后续的RUN命令中生效，因为每个RUN指令都是独立的shell进程。应该用ENV指令来设置全局环境变量，让后续所有步骤都能读取到：

FROM python:3
ENV PYTHONUNBUFFERED 1
# 持久化GDAL相关环境变量，替代临时export
ENV CPLUS_INCLUDE_PATH=/usr/include/gdal
ENV C_INCLUDE_PATH=/usr/include/gdal
RUN mkdir /code
RUN apt-get update && apt-get install --yes libgdal-dev
WORKDIR /code
COPY . /code/
RUN pip install -r requirements.txt

2. 严格匹配GDAL版本 #

系统安装的libgdal-dev版本必须和pip安装的gdal版本完全一致，这是引发这类编译错误的核心原因之一。你可以先查看系统提供的GDAL版本：

# 先启动基础镜像的临时容器查看版本
docker run -it --rm python:3 bash -c "apt-cache show libgdal-dev | grep Version"

假设输出的版本是2.4.0，那你需要在requirements.txt里指定对应的GDAL版本：

Django==2.1.5
psycopg2==2.7.6.1
numpy
gdal==2.4.0

3. 强制指定编译路径（可选兜底方案） #

如果还是出现编译错误，可以在pip安装时明确指定GDAL的头文件路径，确保编译过程能正确找到依赖：

# 替换原来的pip install命令
RUN pip install --global-option=build_ext --global-option="-I/usr/include/gdal" -r requirements.txt

额外小提示 #

你的Django版本是2.1.5，属于比较旧的版本，如果用最新的python:3基础镜像，系统自带的GDAL版本可能过高导致兼容性问题。可以尝试换成更适配的基础镜像，比如python:3.8-slim-buster，这个镜像的GDAL版本相对稳定，和旧版Django的适配性更好。

内容的提问来源于stack exchange，提问作者Sam B.