GeoDjango启动报错：无法找到GDAL库，求助配置问题解决

1. 确认GDAL库文件的实际命名 #

• 定位GDAL安装目录下的核心库文件：
  • Windows：查看GDAL安装路径/bin目录，寻找gdal.dll或带版本号的文件（如gdal304.dll）
  • Linux/macOS：查看GDAL安装的lib目录（如/usr/lib、/usr/local/lib），寻找libgdal.so、libgdal.so.30.4这类文件
• 记录库文件的基础名称（比如Windows下的gdal或gdal304，Linux下的gdal）

2. 在Django配置中明确指定GDAL路径 #

打开项目的settings.py，添加或修改以下配置：

import os

# Windows示例（替换为你的GDAL实际路径）
GDAL_LIBRARY_PATH = os.path.join('C:/path/to/gdal', 'bin', 'gdal304.dll')

# Linux/macOS示例（替换为实际库路径）
# GDAL_LIBRARY_PATH = '/usr/lib/libgdal.so.30.4'

# 若环境变量已正确配置，也可直接指定库名前缀
# GDAL_LIBRARY_PATH = 'gdal304'

3. 验证Python的GDAL绑定 #

打开Python终端执行以下命令，确认GDAL能被Python正常调用：

from osgeo import gdal
print(gdal.__version__)

• 若报错，说明Python的GDAL绑定未正确安装，需安装与本地GDAL版本匹配的包：
  • Windows：pip install gdal==3.4.3
  • Linux：使用系统包管理器安装python3-gdal，或执行pip install gdal==3.4.3
  • macOS：先通过brew install gdal安装GDAL，再执行pip install gdal==3.4.3

4. 检查系统环境变量配置 #

• Windows：确保GDAL的bin目录已添加到PATH环境变量，重启终端或IDE使配置生效，可通过gdalinfo --version验证GDAL是否全局可用
• Linux：将GDAL的lib目录添加到LD_LIBRARY_PATH：

  export LD_LIBRARY_PATH=/usr/lib/gdal:$LD_LIBRARY_PATH
  

• macOS：将GDAL的lib目录添加到DYLD_LIBRARY_PATH：

  export DYLD_LIBRARY_PATH=/usr/local/lib/gdal:$DYLD_LIBRARY_PATH
  

5. 确认GeoDjango配置完整性 #

检查settings.py的INSTALLED_APPS是否包含django.contrib.gis：

INSTALLED_APPS = [
    # 其他应用
    'django.contrib.gis',
]

完成以上步骤后，重新运行python manage.py runserver即可启动GeoDjango应用。

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