GeoDjango导入LayerMapping报错，求排查解决方法

我之前在Django 1.11搭配GDAL的环境里也踩过类似的坑，结合你的配置情况，咱们先理清报错原因，再一步步解决：

核心报错原因 #

你提到layermapping.py文件存在但依然导入失败，本质问题是GDAL的Python绑定没有被你的Python环境正确识别，导致Django的GIS模块无法完整初始化。Django的LayerMapping依赖GDAL提供的地理空间能力，如果GDAL加载失败，即使文件存在，Django也无法正常加载这个类。

分步排查与解决 #

1. 先验证GDAL在Python中能否正常导入 #

打开Python交互窗口，输入以下命令：

from osgeo import gdal
print(gdal.__version__)

如果这里报错，说明GDAL的Python绑定没配置好，需要：

• 把GDAL安装目录下的python27/site-packages路径（比如C:\Program Files\GDAL\python27\site-packages）添加到系统环境变量的PYTHONPATH中；
• 把GDAL的bin目录（比如C:\Program Files\GDAL\bin）添加到系统PATH环境变量的最前面，确保Python能优先找到GDAL的动态链接库。

2. 检查Django项目的GIS配置是否正确 #

打开项目的settings.py，确认以下两点：

• django.contrib.gis已经添加到INSTALLED_APPS列表中：

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

• 数据库引擎设置为PostGIS的后端：

  DATABASES = {
      'default': {
          'ENGINE': 'django.contrib.gis.db.backends.postgis',
          'NAME': '你的数据库名',
          'USER': '用户名',
          'PASSWORD': '密码',
          'HOST': 'localhost',
          'PORT': '5432',
      }
  }
  

3. 手动指定GDAL的依赖路径（如果上述步骤无效） #

有些情况下，即使环境变量配置了，Python依然找不到GDAL的辅助文件，可以在settings.py的最开头添加以下代码，手动指定路径（替换成你实际的GDAL安装路径）：

import os
# 替换成你的GDAL安装目录下的对应路径
os.environ['GDAL_DATA'] = 'C:/Program Files/GDAL/gdal-data'
os.environ['PROJ_LIB'] = 'C:/Program Files/GDAL/projlib'

4. 验证LayerMapping的导入 #

完成上述配置后，重启Python交互窗口，再次尝试：

from django.contrib.gis.utils import LayerMapping

如果还是报错，可以先导入django.contrib.gis.utils模块，查看它的可用属性：

import django.contrib.gis.utils
print(dir(django.contrib.gis.utils))

如果输出里没有LayerMapping，说明GDAL的问题依然存在，需要重新检查GDAL的安装和环境变量配置。

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