MySQL 8.0.16+ 应优先使用_ST_Distance_Sphere计算球面距离，单位米、支持WGS84；参数顺序为POINT(longitude, latitude)，字段需为SRID 4326的POINT类型并建立空间索引，否则返回NULL或性能极差。
MySQL 8.0+ 直接用 _ST_Distance_Sphere 计算球面距离
如果你的 MySQL 版本 ≥ 8.0.16，_ST_Distance_Sphere 是最直接、最准确的选择——它原生支持 WGS84 椭球模型，结果单位是米，无需手动转弧度或套公式。
常见错误是传入顺序反了：该函数要求参数为 POINT(longitude, latitude)（注意：先经度后纬度），和日常说“北京纬度39.9，经度116.4”相反。
- 错误写法：
POINT(39.9, 116.4)→ 把纬度当经度，结果偏差可达上千公里 - 正确写法：
POINT(116.4, 39.9) - 必须确保字段类型是
POINT，不是VARCHAR或DOUBLE；否则函数返回NULL且无提示 - 若原始数据存的是两个
DOUBLE字段（如lng,lat），需用ST_PointFromText(CONCAT('POINT(', lng, ' ', lat, ')'))构造，但性能较差，建议提前建GENERATED COLUMN
SELECT _ST_Distance_Sphere(
ST_PointFromText('POINT(116.4 39.9)'),
ST_PointFromText('POINT(121.47 31.23)')
) AS distance_m;低版本 MySQL（5.7 及以下）不能用 _ST_Distance_Sphere
MySQL 5.7 不支持 _ST_Distance_Sphere，调用会报错 FUNCTION db._ST_Distance_Sphere does not exist。此时别硬改函数名，也别试图用 ST_Distance 替代——它算的是平面欧氏距离（单位是“度”），在高纬度地区误差极大（北京到哈尔滨可能差出 200 km）。
可行方案只有两个：
- 升级到 MySQL 8.0+（推荐，一劳永逸）
- 手写 Haversine 公式（兼容所有版本，但需自己处理单位、精度和 NULL）
简单安全的 Haversine 写法（单位：米）：
SELECT 6371 * 1000 * ACOS( COS(RADIANS(lat1)) * COS(RADIANS(lat2)) * COS(RADIANS(lng2) - RADIANS(lng1)) + SIN(RADIANS(lat1)) * SIN(RADIANS(lat2)) ) AS distance_m FROM locations WHERE lat1 IS NOT NULL AND lat2 IS NOT NULL;
_ST_Distance_Sphere 性能关键：必须加空间索引
即使你用了正确的函数，没建空间索引，查询一过万行就会明显变慢——因为全表扫描每个点都要算一次球面距离。
- 空间索引只能建在
POINT列上，不能建在普通DOUBLE字段上 - 建索引语句：
ALTER TABLE places ADD COLUMN loc POINT SRID 4326;，然后UPDATE places SET loc = ST_PointFromText(CONCAT('POINT(', lng, ' ', lat, ')'), 4326);，最后CREATE SPATIAL INDEX idx_loc ON places(loc); - 查询时 WHERE 条件要配合
ST_DWithin先粗筛（比如先找 10km 内的点），再用_ST_Distance_Sphere精排
例如查“离某点 5km 内的所有门店并按距离排序”：
SELECT id, name,
ROUND(_ST_Distance_Sphere(loc, ST_PointFromText('POINT(116.4 39.9)', 4326))) AS dist_m
FROM places
WHERE ST_DWithin(loc, ST_PointFromText('POINT(116.4 39.9)', 4326), 5000)
ORDER BY dist_m;SRID 4326 是硬性前提，不是可选项
_ST_Distance_Sphere 要求两个 POINT 的 SRID 都是 4326（WGS84 坐标系）。如果建表时没指定，或从其他系统导入数据时丢失了 SRID，函数会静默返回 NULL，不报错也不提示。
- 检查方式：
SELECT ST_SRID(loc) FROM places LIMIT 1;—— 必须返回4326 - 修复方式：
UPDATE places SET loc = ST_SetSRID(loc, 4326);（前提是原始坐标确实是 WGS84，国内 GCJ-02 或 BD-09 坐标系需先纠偏） - 建表时就该写清楚：
loc POINT SRID 4326，避免后续补救
这点容易被忽略：明明函数写对了、顺序也没错，结果全是 NULL，大概率就是 SRID 缺失或不匹配。
