Mac系统Django配置GDAL出现GDAL_LIBRARY_PATH异常如何解决？

1. 修复系统级GDAL安装 #

你之前执行的brew install django是安装Django本身，并未安装GDAL的系统依赖，先执行命令安装系统级GDAL：

brew install gdal

安装完成后执行以下命令确认版本：

gdalinfo --version

2. 获取GDAL动态库实际路径 #

brew安装的GDAL默认路径在/usr/local/lib/（Intel芯片Mac）或者/opt/homebrew/lib/（Apple Silicon芯片Mac），执行以下命令查找具体的库文件路径：

find /usr/local/lib /opt/homebrew/lib -name "libgdal.dylib"

输出的结果就是GDAL库的绝对路径，比如Apple Silicon设备通常输出为/opt/homebrew/lib/libgdal.dylib，Intel设备通常为/usr/local/lib/libgdal.dylib。

3. 在Django配置文件中指定路径 #

打开Django项目的settings.py文件，在末尾添加如下配置：

# 替换为上一步查到的GDAL库实际路径
GDAL_LIBRARY_PATH = '/opt/homebrew/lib/libgdal.dylib'
# 若用到地理相关的其他依赖，可同步配置（可选）
GEOS_LIBRARY_PATH = '/opt/homebrew/lib/libgeos_c.dylib'
PROJ_LIBRARY_PATH = '/opt/homebrew/lib/libproj.dylib'

如果是Intel芯片的Mac，把路径前缀替换为/usr/local/lib/即可。

4. 验证修复 #

重新启动Django服务即可解决报错。如果仍有异常，检查以下两点：

• 配置的路径和find命令查到的实际路径是否完全一致
• 确认pip安装的GDAL版本和系统安装的GDAL版本匹配，执行pip show gdal查看版本，和gdalinfo --version的大版本号需要保持一致，如果不匹配执行以下命令重装：

pip uninstall GDAL
pip install GDAL==$(gdalinfo --version | cut -d' ' -f2 | cut -d',' -f1)

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