Django 3.2环境下GDAL库查找失败问题求助

核心问题分析 #

你之前的错误根源在于：

• 把宿主机的GDAL库路径配置到了容器的settings.py中，而Docker容器的文件系统与宿主机完全隔离，自然找不到文件。
• Docker镜像中可能未正确安装GDAL依赖，导致容器内根本不存在GDAL库文件。

分步解决方案 #

1. 确认容器内GDAL库的实际路径

首先进入运行中的Django容器（或临时启动一个容器镜像）：

docker-compose exec <你的Django服务名称> bash

在容器内执行查找命令，定位GDAL库文件：

find / -name "libgdal.so*" 2>/dev/null

输出示例（不同环境路径可能有差异）：

/usr/lib/x86_64-linux-gnu/libgdal.so.20
/usr/lib/x86_64-linux-gnu/libgdal.so.20.5.2
/usr/lib/x86_64-linux-gnu/libgdal.so

优先选择不带具体小版本号的软链接路径（比如/usr/lib/x86_64-linux-gnu/libgdal.so.20），避免版本更新后路径失效。

2. 修正Django配置文件settings.py

将找到的容器内路径填入：

GDAL_LIBRARY_PATH = "/usr/lib/x86_64-linux-gnu/libgdal.so.20"

注意：不要使用宿主机的路径，必须用容器内实际存在的路径。

3. 确保Dockerfile中正确安装GDAL依赖

在你的项目Dockerfile中添加以下步骤，确保容器内完整安装GDAL及依赖：

# 更新系统包并安装GDAL系统依赖
RUN apt-get update && apt-get install -y --no-install-recommends \
    libgdal-dev \
    gdal-bin \
    && rm -rf /var/lib/apt/lists/*

# 设置环境变量，让pip能找到GDAL头文件
ENV CPLUS_INCLUDE_PATH=/usr/include/gdal
ENV C_INCLUDE_PATH=/usr/include/gdal

# 安装与系统匹配的GDAL版本（修复原命令语法错误，将.."改为.）
RUN pip install GDAL==$(gdal-config --version | awk -F'[.]' '{print $1"."$2}')

# 指定兼容的setuptools版本，避免与旧版GDAL冲突
RUN pip install setuptools<=65.5.1

4. 重新构建镜像并启动服务

docker-compose build --no-cache
docker-compose up

额外注意事项 #

• 不要在requirements.txt中直接指定GDAL版本，不同系统/镜像的GDAL版本可能不一致，用上述动态安装方式更可靠。
• 如果构建镜像时仍出现依赖冲突，可根据报错信息调整setuptools或GDAL的兼容版本范围。

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