添加django.contrib.gis到Django INSTALLED_APPS时GDAL库找不到求助

开发者阿泽

2026-6-24

解决Django集成django.contrib.gis时的GDAL库找不到问题

核心问题定位

你指定的GDAL_LIBRARY_PATH指向了gdal-data目录，这是GDAL的地理数据文件目录，不是GDAL的核心库文件路径，这是导致错误的关键。

具体解决步骤

找到正确的GDAL库文件：PostgreSQL Stack Builder安装的GDAL库文件位于C:\Program Files\PostgreSQL\16\bin目录下，文件名类似gdal307.dll（匹配错误提示中的版本号，比如错误里列的gdal307就对应这个文件）。
修改settings.py中的路径配置：将GDAL_LIBRARY_PATH指向该dll文件的完整路径，注意用原始字符串避免转义：
```
GDAL_LIBRARY_PATH = r'C:\Program Files\PostgreSQL\16\bin\gdal307.dll'
```
添加系统环境变量：将C:\Program Files\PostgreSQL\16\bin添加到系统的PATH环境变量中，然后重启你的命令行工具或IDE，确保环境变量生效。
验证GDAL可用性：打开命令行输入gdalinfo --version，如果能正常输出GDAL版本信息，说明GDAL已正确配置。

调整数据库引擎：在settings.py的DATABASES配置中，将ENGINE改为GIS专用的后端：

DATABASES = {
    'default': {
        'ENGINE': 'django.contrib.gis.db.backends.postgis',
        'NAME': 'your_db_name',
        'USER': 'your_db_user',
        'PASSWORD': 'your_db_password',
        'HOST': 'localhost',
        'PORT': '5432',
    }
}

确保依赖兼容：确认你的Django版本与GDAL版本兼容（例如Django 4.x适配GDAL 3.x），同时安装psycopg2-binary（PostGIS依赖的PostgreSQL驱动）：
```
pip install psycopg2-binary
```
最后运行python manage.py check，验证配置是否正确。