Django 5.0 起正式移除了 OSMGeoAdmin 类，若项目升级后仍引用该类将触发 ImportError；正确做法是改用 GISModelAdmin，并确保 PostGIS 环境配置完整。
django 5.0 起正式移除了 `osmgeoadmin` 类，若项目升级后仍引用该类将触发 importerror；正确做法是改用 `gismodeladmin`，并确保 postgis 环境配置完整。
在 Django 5.0 及更高版本中，django.contrib.gis.admin.OSMGeoAdmin 已被完全移除（参见 Django 5.0 发布说明），这是 Django GIS 模块现代化重构的一部分。你遇到的错误：
ImportError: cannot import name 'OSMGeoAdmin' from 'django.contrib.gis.admin'
根本原因正是代码中仍保留了已弃用的导入语句：
# ❌ 错误：Django 5.0+ 不再支持 from django.contrib.gis.admin import OSMGeoAdmin
✅ 正确的替代方案是使用统一的 GISModelAdmin —— 它继承自 ModelAdmin 并原生支持地理字段渲染（包括 OpenStreetMap 底图），且无需额外配置即可兼容 OSM 地图服务。
✅ 迁移步骤
-
更新 admin.py
将旧导入和类继承替换为：from django.contrib import admin from django.contrib.gis.admin import GISModelAdmin # ✅ 替代 OSMGeoAdmin from .models import User, Land, LandTransfers, NFTs, AuthTokens, TaxesFees @admin.register(Land) # 示例：假设 Land 模型含 PointField / PolygonField class LandAdmin(GISModelAdmin): # ✅ 继承 GISModelAdmin list_display = ('name', 'location') # 可选：启用地图缩放、默认中心点等 # default_lon = 80.0 # default_lat = 26.0 # default_zoom = 6 验证 GIS 依赖环境
GISModelAdmin 仍需底层 GEOS/GDAL 支持。若此前手动指定路径（如 GDAL_LIBRARY_PATH），请确认路径指向实际存在的动态库文件，且架构（x64/x86）与 Python 一致。推荐使用 OSGeo4W 或 conda install -c conda-forge gdal geos 统一管理。-
检查数据库与迁移
确保 PostgreSQL 数据库已启用 postgis 扩展：CREATE EXTENSION IF NOT EXISTS postgis; CREATE EXTENSION IF NOT EXISTS postgis_topology;
再运行迁移命令：
python manage.py makemigrations python manage.py migrate
⚠️ 注意事项
- GISModelAdmin 默认使用 OpenStreetMap 作为底图，无需额外配置 OSMGeoAdmin 的 map_template 或 extra_js；
- 若需自定义地图行为（如切换为 Mapbox 或添加图层），可通过重写 get_map_options() 方法实现；
- GeoModelAdmin 同样已被移除，请勿尝试回退使用；
- Django 4.2 仍支持 OSMGeoAdmin，但已标记为 deprecated，建议尽早迁移到 GISModelAdmin 以保障长期兼容性。
完成上述调整后，makemigrations 将正常执行，地理模型管理界面也将完整渲染交互式地图控件。
