MySQL的ST_Distance_Sphere计算球面距离需POINT类型+SRID 4326+空间索引,否则慢且不准;建表、插入、查询均须严格遵循WGS84规范,配合ST_DWithin过滤再排序,并注意索引失效场景及缓存优化。

MySQL 的 ST_Distance_Sphere 可以直接算骑手和商家的球面距离(单位米),但必须用 POINT 类型 + SRID 4326 + 空间索引,否则查得慢还不准。
建表时必须用 SRID 4326 的 POINT 字段
MySQL 空间函数对坐标系敏感,ST_Distance_Sphere 只认 WGS84(即 SRID 4326)。如果存的是普通 DECIMAL 经纬度,或者用了别的 SRID(比如 0 或 3857),函数会返回 NULL 或报错 ER_SPATIAL_CANT_HAVE_NULL_SRID。
正确写法:
CREATE TABLE merchants ( id INT PRIMARY KEY, location POINT NOT NULL SRID 4326, name VARCHAR(100) ); CREATE SPATIAL INDEX idx_location ON merchants(location);
插入数据时也得显式指定 SRID:
INSERT INTO merchants VALUES (1, ST_GeomFromText('POINT(116.48 39.92)', 4326), '麦当劳西直门店');
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 别用
ST_PointFromText('POINT(...)', 4326)—— MySQL 8.0.25+ 才支持,低版本要用ST_GeomFromText - 经度在前、纬度在后(
POINT(long lat)),反了会导致距离严重偏差 -
POINT字段不能为NULL,否则空间索引失效
查询时用 ST_Distance_Sphere 配合 WHERE + ORDER BY
想查“3公里内且最近的5家商家”,不能只靠 ORDER BY ST_Distance_Sphere(...) —— 那会全表扫描。得先用空间关系过滤出候选集,再排序。
推荐写法:
SELECT id, name,
ST_Distance_Sphere(location, POINT(116.49, 39.91)) AS distance
FROM merchants
WHERE ST_DWithin(location, POINT(116.49, 39.91), 3000)
ORDER BY distance
LIMIT 5;
注意:
-
ST_DWithin是 MySQL 8.0.29+ 才支持的高效空间范围判断函数,底层走空间索引;低于该版本只能用MBRContains(ST_Envelope(ST_Buffer(...)), location),麻烦且不准 -
POINT(116.49, 39.91)是骑手当前坐标(经度、纬度),必须和表中字段 SRID 一致 - 距离单位是米,
3000表示 3 公里;传毫秒级时间戳或字符串会直接报错
常见错误:明明建了空间索引却没走索引
执行 EXPLAIN 发现 key 列为 NULL?大概率是以下原因:
- 查询中对
location字段用了函数,比如WHERE ST_X(location) > 116—— 空间索引失效,改用ST_Contains(ST_MakeEnvelope(...), location) - WHERE 条件里混用了非空间字段(如
AND status = 'open')但没给它建联合索引,优化器可能放弃空间索引 - 表里
POINT数据有大量NULL或非法值(如纬度写成 120),MySQL 会静默跳过这些行,导致统计信息不准,索引选择失败 - MySQL 8.0 默认
optimizer_switch='use_index_extensions=off',某些场景下需手动打开
真实外卖系统里,骑手坐标频繁变动,建议把“附近商家”结果缓存 30 秒,并用 Redis GEO 做兜底;MySQL 空间索引适合做精准距离排序,但扛不住每秒几百次的实时计算——这点容易被忽略。

















