MySQL自定义标量函数必须显式声明DETERMINISTIC，否则报错1418；需避免非确定性函数和SQL语句；推荐用DECIMAL(10,8)存经纬度、前缀命名、haversine公式计算球面距离，并注意NULL与边界处理。
MySQL标量函数必须用DETERMINISTIC声明
MySQL要求自定义函数明确声明确定性，否则创建会报错 ERROR 1418。即使函数逻辑本身是确定的（相同输入总得相同输出），也必须显式加 DETERMINISTIC。漏掉这个关键词是最常见的创建失败原因。
同时注意：函数体里不能出现非确定性函数（如 NOW()、RAND()），也不能执行SQL语句（如 SELECT 或 INSERT），否则会触发 ERROR 1418 或 ERROR 1422。
- 必须加上
DETERMINISTIC关键字 - 参数类型建议统一用
DECIMAL(10,8)存经纬度，避免浮点精度误差 - 函数名别用
distance这类可能和未来内置函数冲突的名字，推荐带前缀如geo_haversine_km
用haversine公式实现球面距离计算
地球是球体，平面勾股定理在经纬度上完全不适用。正确做法是用haversine公式算大圆距离。MySQL没有内置haversine函数，但可以用 SIN、COS、ACOS 和弧度转换组合实现。
关键点：MySQL三角函数单位是弧度，而经纬度是角度，必须先用 RADIANS() 转换；地球平均半径取6371千米（或3959英里）。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录，或需要将该能力封装成可公开复用的 Codex skill。
DELIMITER $$
CREATE FUNCTION geo_haversine_km(
lat1 DECIMAL(10,8), lng1 DECIMAL(10,8),
lat2 DECIMAL(10,8), lng2 DECIMAL(10,8)
) RETURNS DECIMAL(10,3)
READS SQL DATA
DETERMINISTIC
BEGIN
DECLARE R DECIMAL(10,3) DEFAULT 6371.0;
DECLARE phi1 DECIMAL(10,8) DEFAULT RADIANS(lat1);
DECLARE phi2 DECIMAL(10,8) DEFAULT RADIANS(lat2);
DECLARE delta_phi DECIMAL(10,8) DEFAULT RADIANS(lat2 - lat1);
DECLARE delta_lambda DECIMAL(10,8) DEFAULT RADIANS(lng2 - lng1);
<pre class='brush:php;toolbar:false;'>DECLARE a DECIMAL(20,18) DEFAULT
SIN(delta_phi/2) * SIN(delta_phi/2) +
COS(phi1) * COS(phi2) *
SIN(delta_lambda/2) * SIN(delta_lambda/2);
DECLARE c DECIMAL(20,18) DEFAULT 2 * ATAN2(SQRT(a), SQRT(1-a));
RETURN ROUND(R * c, 3);END$$ DELIMITER ;
调用时注意NULL和极值边界
函数对输入很敏感：若任一参数为 NULL，整个结果就是 NULL；若两点重合（经纬度完全一样），a 会是0，c 是0，结果正确为0；但若传入非法经纬度（如纬度>90），ACOS 或 SIN/COS 可能返回 NULL 或报错，MySQL默认不会校验。
- 生产环境建议在调用前用
IFNULL()或COALESCE()处理空值 - 可在函数开头加简单校验，比如
IF lat1 NOT BETWEEN -90 AND 90 OR lng1 NOT BETWEEN -180 AND 180 THEN RETURN NULL; END IF; - 不要依赖函数做高频实时计算——每次调用都走完整三角运算，比查预计算好的距离表慢得多
替代方案：用ST_DistanceSphere更简洁（MySQL 5.7.6+）
如果你用的是 MySQL 5.7.6 或更新版本，其实没必要手写haversine。MySQL原生支持地理空间类型，ST_DistanceSphere() 函数直接接受两个 POINT 值，自动按WGS84椭球模型计算米级距离，精度更高、代码更短、还支持空间索引加速。
例如：SELECT ST_DistanceSphere(POINT(lng1, lat1), POINT(lng2, lat2)) / 1000 AS km; —— 注意参数顺序是 POINT(longitude, latitude)，和常见“lat,lng”习惯相反，填反了结果就全错。
不过它要求字段是 POINT 类型或用 POINT() 构造，如果数据存的是分离的 lat/lng 字段，就得每次构造，性能略低于纯数值函数。但胜在标准、可靠、少踩坑。
