Windows环境下GeoDjango报错：找不到GDAL库/系统错误126求助

我经常碰到Windows+Miniconda环境里GeoDjango的GDAL依赖报错，你遇到的Could not find the GDAL library和OSError: [WinError 126]，本质是GDAL的动态链接库（DLL）没被系统正确识别，或者路径配置不到位。下面是一套经过验证的解决步骤：

1. 用Conda安装完整的GeoDjango依赖栈 #

别用pip单独装GDAL，Conda能自动处理Windows下的依赖和DLL文件，直接在你的conda环境里运行：

conda activate your_env_name
conda install -c conda-forge gdal django postgresql postgis

conda-forge频道提供了预编译的适配Windows的GDAL、PostGIS包，能避开大部分手动配置的麻烦。

2. 配置Django的Settings.py #

打开你的GeoDjango项目的settings.py，添加GDAL和GEOS的路径配置（Conda环境下这些文件默认在Library/bin目录）：

import os

# 配置GDAL和GEOS库路径（注意dll版本号要和你安装的GDAL匹配）
GDAL_LIBRARY_PATH = os.path.join(os.environ['CONDA_PREFIX'], 'Library', 'bin', 'gdal304.dll')
GEOS_LIBRARY_PATH = os.path.join(os.environ['CONDA_PREFIX'], 'Library', 'bin', 'geos_c.dll')

# 替换默认数据库为PostGIS
DATABASES = {
    'default': {
        'ENGINE': 'django.contrib.gis.db.backends.postgis',
        'NAME': 'your_geodb',  # 你要创建的数据库名
        'USER': 'postgres',    # PostgreSQL默认用户名
        'PASSWORD': 'your_db_password',
        'HOST': 'localhost',
        'PORT': '5432',
    }
}

# 确保添加GeoDjango核心应用
INSTALLED_APPS = [
    # ... 其他默认应用
    'django.contrib.gis',
]

小提示：gdal304.dll的版本号（比如304对应GDAL 3.4.x）要和你conda安装的GDAL版本匹配，你可以用conda list gdal查看版本，再调整dll文件名（比如GDAL 3.5.x对应gdal305.dll）。

3. 验证GDAL是否正确加载 #

在激活的conda环境里运行以下命令，测试GDAL是否能被Python识别：

python -c "from osgeo import gdal; print('GDAL版本:', gdal.__version__)"

如果能正常输出版本号，说明GDAL配置成功；如果还是报错，重启你的终端/IDE（环境变量需要重启才能生效）。

4. 配置PostGIS数据库 #

安装完PostgreSQL和PostGIS后，需要创建并启用PostGIS扩展：

1. 打开pgAdmin或者用psql连接到PostgreSQL服务
2. 创建新数据库：CREATE DATABASE your_geodb;
3. 切换到该数据库：\c your_geodb
4. 启用PostGIS扩展：CREATE EXTENSION postgis;

常见坑点排查 #

• 确保你始终在激活的conda环境里运行Django命令（比如python manage.py migrate）
• 如果还是出现WinError 126，检查Library/bin目录下是否存在对应的dll文件，有时候conda安装可能有延迟，重新运行conda install -c conda-forge gdal修复
• 别同时用pip和conda安装GDAL，这会导致依赖冲突

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