已部署Django、PostGIS、GDAL等环境，为何GeoDjango地图无内容显示

1. 修正settings.py中的OSGEO配置逻辑错误 #

当前配置存在两处会直接导致地图渲染失败的问题：

• 前置的import gdal代码块路径完全无效：这类配置抄自老旧的WinPython内置GIS依赖的模板，pip安装的GDAL Python绑定包不会附带原生C库的osgeo目录，只要该导入成功，就会将GEOS_LIBRARY_PATH、GDAL_LIBRARY_PATH指向不存在的路径，后续Windows分支的配置只会修改系统环境变量，无法覆盖这两个Python层的配置值，最终导致Django加载原生空间库失败，地图组件无法初始化
• 硬编码的gdal301.dll版本号无通用性：如果安装的GDAL为3.2/3.4/3.6/3.8等其他版本，该文件名不存在，会直接触发GDAL加载异常

可直接使用的Windows环境下配置：

# 完全删除之前错误的try导入gdal的冗余配置块
if os.name == 'nt':
    import platform
    OSGEO4W = r"C:\OSGeo4W"
    if '64' in platform.architecture()[0]:
        OSGEO4W += "64"
    assert os.path.isdir(OSGEO4W), f"OSGeo4W安装目录不存在: {OSGEO4W}"
    # 配置系统环境变量
    os.environ['OSGEO4W_ROOT'] = OSGEO4W
    os.environ['GDAL_DATA'] = os.path.join(OSGEO4W, "share", "gdal")
    os.environ['PROJ_LIB'] = os.path.join(OSGEO4W, "share", "proj")
    os.environ['PATH'] = os.path.join(OSGEO4W, "bin") + ";" + os.environ['PATH']
    # 直接指向bin目录下的原生库，不硬编码版本号
    GEOS_LIBRARY_PATH = os.path.join(OSGEO4W, "bin", "geos_c.dll")
    # 移除原来硬编码GDAL库版本号的配置，Django会自动扫描bin目录下匹配的GDAL库

配置完成后，进入Django Shell做基础环境校验，无报错再继续排查：

python manage.py shell

from django.contrib.gis.geos import GEOSGeometry
# 测试空间对象初始化
test_point = GEOSGeometry('POINT(116.39 39.91)')
print(test_point.wkt)

2. 校验数据库侧的空间数据有效性 #

地图无内容展示的高频原因是数据库无有效空间数据，或空间字段配置异常：

• 核对geoshops_shop表的空间字段配置，在PostgreSQL中执行查询：

  SELECT f_geometry_column, srid, type FROM geometry_columns WHERE f_table_name = 'geoshops_shop';
  

  确认location字段的SRID为4326，类型为Point
• 查询表内实际空间数据：

  SELECT id, name, ST_AsText(location) FROM geoshops_shop LIMIT 5;
  

  如果返回空结果，说明无点位数据，地图自然不会渲染内容，可插入测试数据验证：

  INSERT INTO geoshops_shop (name, location, address, city) 
  VALUES ('测试点位', ST_SetSRID(ST_MakePoint(116.397128, 39.916527), 4326), '东长安街1号', '北京');
  

• 检查SRID匹配性：如果前端地图默认使用3857投影，后端返回的空间数据SRID不匹配且未做投影转换，会导致点位落在地图可视范围外，出现全白的视觉效果

3. 排查前端资源加载异常 #

• 打开浏览器开发者工具的网络面板，检查Django自带的GeoAdmin地图组件依赖的静态资源（OpenLayers脚本、Proj4js投影定义、Django GIS组件JS）是否存在404、加载失败、跨域报错的情况
• 检查地图初始视野配置：如果默认中心点、缩放级别的配置和存储的点位完全不相关，哪怕有点位也不会在当前视野内展示，可在控制台手动将地图视角调整到测试点位的经纬度范围，验证是否能正常渲染
• 查看浏览器控制台的脚本报错：如果存在投影定义缺失、瓦片请求失败、JS语法报错，会直接导致地图容器无法初始化

4. 其他常见问题排查 #

• Windows环境下确认Python进程拥有OSGeo4W安装目录的读取权限，无权限会导致原生dll加载失败，地图组件退化为空白文本框
• 确认PROJ_LIB路径指向的目录下存在proj.db文件，路径错误会导致空间投影转换失败，点位无法正确映射到屏幕坐标

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