GeoDjango distance查询报错因SRID不一致，须确保模型字段与查询点同为srid=4326且geography=True；性能优化应先用dwithin粗筛再distance精算，并启用postgis扩展。
GeoDjango 的 distance 查询为什么总报错 DatabaseError: ST_Distance cannot be used with mixed SRIDs
这是最常卡住人的第一步：你调了 distance，但模型字段和查询点的坐标系（SRID）不一致。GeoDjango 不会自动转换，它直接把你的参数扔给 PostGIS，而 PostGIS 拒绝混合 SRID 的几何运算。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 确认模型中
PointField定义时是否显式指定了srid=4326（WGS84，推荐默认）；没写就默认是 4326，但别赌 - 构造查询点时必须用
GEOSGeometry('POINT(121.47 31.23)', srid=4326)，不能只传坐标元组或字符串 - 如果用
from django.contrib.gis.geos import Point，记得加srid=4326参数：Point(121.47, 31.23, srid=4326) - PostGIS 中检查表字段 SRID：
SELECT Find_SRID('public', 'myplace', 'location');，确保和查询点一致
想查“5 公里内所有咖啡馆”，filter(location__distance_lte=...) 性能很慢怎么办
直接用 distance_lte 会让 PostGIS 对每条记录都算一次球面距离，没有索引加速 —— 即使你建了 GIST 索引也没用，因为 ST_Distance 无法走索引。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 先用
location__dwithin做粗筛：filter(location__dwithin=(point, D(km=5)))，它会转成ST_DWithin，能命中空间索引 -
D(km=5)的单位必须和字段 SRID 匹配：SRID 4326 时，D(km=5)是近似值（地球曲率已考虑），但底层用的是米制；若字段是 SRID 3857，则直接传米：D(m=5000) - 如需精确排序或过滤，再在
dwithin结果上链式调用annotate(distance=Distance('location', point)).order_by('distance')，这时才触发ST_Distance - 别忘了在模型字段加索引：
location = PointField(srid=4326, geography=True, blank=True, null=True)+db_index=True
PostGIS 安装好了，python manage.py migrate 却提示 Extension "postgis" does not exist
GeoDjango 要求数据库里提前启用 postgis 扩展，不是装完 PostGIS 就自动有。Django 迁移脚本会尝试建空间字段，但发现扩展没开就直接失败。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 连进你的数据库（比如
psql -d myproject），手动执行：CREATE EXTENSION IF NOT EXISTS postgis; - 如果要用地理距离函数（比如
ST_DWithin处理经纬度），还得开postgis_topology和postgis_raster？不用。只要postgis就够，但确保你用的是geography=True字段或显式调D类型 - 检查用户权限：执行
CREATE EXTENSION的数据库用户必须是 superuser 或有CREATEDB权限；Django 连接用的账号不需要，只要能读写表就行 - 开发环境常用坑：Docker 启的 PostGIS 镜像（如
postgis/postgis）默认已开扩展，但自己编译或 macOS Homebrew 装的往往没开
geography=True 和 srid=4326 到底要不要一起用
要，而且必须一起。单独设 srid=4326 只是声明坐标系，不启用地理计算；单独设 geography=True 会强制用 WGS84（即 SRID 4326），但字段定义不明确，容易在迁移或 introspect 时出问题。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 生产环境一律用：
location = PointField(srid=4326, geography=True, blank=True, null=True) -
geography=True让 PostGIS 把该字段当“地理类型”（geography），所有距离、面积函数自动按球面算，单位是米；否则是“几何类型”（geometry），得手动投影转换 - 不要用
srid=3857+geography=True：3857 是投影坐标系，geography类型只接受地理坐标系（如 4326） - 注意 Django admin 显示：
geography=True字段在 admin 地图小部件里可能不渲染，这是正常现象，不影响查询
真正麻烦的是跨坐标系聚合、和外部 GIS 工具交换数据时的隐式转换——那些地方没日志、没报错、只有结果偏差几公里，得靠 ST_Transform 和反复验证坐标来源才能揪出来。
