MySQL自定义函数必须显式声明DETERMINISTIC，即使逻辑确定也需强制标注；距离计算须用弧度制Haversine公式（半径6371km），禁用欧氏近似；需主动校验NULL和坐标有效性，并结合边界框优化查询性能。
MySQL自定义函数必须用DETERMINISTIC声明
MySQL要求所有自定义函数必须显式声明确定性（DETERMINISTIC）或非确定性（NOT DETERMINISTIC），否则创建会报错 ERROR 1418 (HY000)。即使函数逻辑完全依赖输入参数，也必须加 DETERMINISTIC——这是MySQL的强制校验，和实际是否真“确定”无关。
实操建议：
- 函数体里只用
RETURN表达式，避免SELECT ... INTO或变量赋值，减少隐式状态依赖 - 如果后续要用于索引字段计算或视图，必须确保函数不调用
NOW()、RAND()等非确定性函数 - 声明时直接写
DETERMINISTIC，别省略；READS SQL DATA可选但非必需
用Haversine公式实现距离计算，别用平面坐标近似
地球是球面，直接用 (lat1-lat2)^2 + (lng1-lng2)^2 算欧氏距离在中高纬度误差极大（比如北京到东京，误差可能超200km）。必须用Haversine公式算球面大圆距离。
实操建议：
- 输入经纬度单位必须是**弧度**，不是度数：用
RADIANS(lat)转换，别手写lat * PI()/180 - 地球平均半径取
6371km（常用），若需英里则用3959；别硬编码6378（赤道半径）或6357（极半径） - 函数返回单位统一为公里，避免在应用层再转换，减少出错点
示例函数体关键行：
RETURN 6371 * 2 * ASIN(SQRT( POWER(SIN((lat2 - lat1) / 2), 2) + COS(lat1) * COS(lat2) * POWER(SIN((lng2 - lng1) / 2), 2) ));
调用时注意NULL和无效坐标导致结果为NULL
只要任一输入参数为 NULL（比如地址解析失败未补默认值），整个函数返回 NULL，且不会报错。这容易掩盖数据质量问题，尤其在 WHERE 条件中使用时，整行被过滤掉却不提示。
实操建议：
- 在函数开头用
IF lat1 IS NULL OR lng1 IS NULL OR lat2 IS NULL OR lng2 IS NULL THEN RETURN NULL; END IF;显式拦截，比依赖隐式NULL传播更可控 - 业务SQL中调用前先
WHERE lat1 IS NOT NULL AND lng1 IS NOT NULL AND lat2 IS NOT NULL AND lng2 IS NOT NULL - 对原始坐标字段加
CHECK(lat BETWEEN -90 AND 90 AND lng BETWEEN -180 AND 180)约束，防脏数据入库
性能敏感场景下，别在WHERE里直接调用该函数
每次执行都要计算三角函数，无法利用索引。如果要查“5km内所有门店”，用该函数写 WHERE distance_func(lat, lng, @user_lat, @user_lng) < 5 会导致全表扫描。
实操建议：
- 先用简单边界框快速过滤：
WHERE lat BETWEEN @user_lat - 0.05 AND @user_lat + 0.05 AND lng BETWEEN @user_lng - 0.05 AND @user_lng + 0.05（0.05度≈5.5km） - 再在子查询或CTE里用距离函数精筛
- 若高频调用，考虑把距离预计算并存到冗余字段，用触发器或应用层维护
函数本身不难写，真正麻烦的是数据质量校验、边界条件处理和查询性能权衡——尤其是当坐标来自用户手动输入或第三方API时，NULL、越界、精度丢失这些情况比公式写错更常引发线上问题。
