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 缺失或不匹配。











