ThinkPHP中计算两点距离需用Haversine公式并转弧度，返回米；高德坐标须先纠偏；查询附近门店应使用MySQL 5.7+的ST_Distance_Sphere()优化性能。
ThinkPHP 里怎么算两个经纬度之间的距离
直接用 sqrt() + pow() 手写 Haversine 公式容易出错，而且不兼容高德/百度坐标系偏移。ThinkPHP 本身不内置地理距离计算，得自己封装或借助扩展，但核心逻辑必须自己把关。
- 推荐在模型或服务类里写一个
getDistance()方法，输入两个$lat1、$lng1和$lat2、$lng2，返回单位为米的浮点数 - 务必用弧度（
deg2rad()）参与三角运算，否则结果会差几个数量级 - 如果数据来自高德地图，要先调用高德 API 的
/geoconv接口纠偏——国内 GCJ-02 坐标系和 WGS-84 的误差可达 500 米 - 示例片段：
public function getDistance($lat1, $lng1, $lat2, $lng2) {<br> $lat1 = deg2rad($lat1);<br> $lng1 = deg2rad($lng1);<br> $lat2 = deg2rad($lat2);<br> $lng2 = deg2rad($lng2);<br> $dlat = $lat2 - $lat1;<br> $dlng = $lng2 - $lng1;<br> $a = sin($dlat/2) * sin($dlat/2) + cos($lat1) * cos($lat2) * sin($dlng/2) * sin($dlng/2);<br> $c = 2 * atan2(sqrt($a), sqrt(1-$a));<br> return 6371 * $c * 1000; // 返回米
ThinkPHP 查询附近门店：用 whereRaw 写 SQL 地理条件
别在 PHP 层查出全部数据再过滤，性能崩得很快。得让 MySQL 帮你算——但注意 MySQL 5.7+ 才原生支持 ST_Distance_Sphere()，老版本只能手写表达式。
- MySQL 5.7+ 推荐：
whereRaw('ST_Distance_Sphere(point(lng, lat), point(?, ?)) - MySQL 5.6 或更低：用
whereRaw('6371 * acos(cos(radians(?)) * cos(radians(lat)) * cos(radians(lng) - radians(?)) + sin(radians(?)) * sin(radians(lat))) - 确保
lat和lng字段有联合索引，否则全表扫描；但注意 MySQL 的 B-Tree 索引对地理范围查询效果有限，大数据量建议上POINT类型 +SPATIAL索引 - ThinkPHP 的
query构建器不自动转义?在whereRaw中的参数，必须手动传参数组，漏了就会 SQL 报错
TP6 模型搜索时怎么避免 select * 导致的 N+1 和精度丢失
用 select(['id', 'name', 'lat', 'lng']) 不够，因为距离值不是数据库字段，得在查询里动态算出来，又不能让 PHP 做二次加工。
- 在
field()或fieldRaw()里直接加距离计算字段：fieldRaw('*, ST_Distance_Sphere(point(lng, lat), point(?, ?)) as distance', [$lng, $lat]) - 注意：
distance是别名，不能在where里直接用（MySQL 不允许 WHERE 引用 SELECT 别名），排序或筛选要用原始表达式 - 如果用
order('distance')，TP6 会自动包裹反引号，但distance是计算字段，得写成orderRaw('ST_Distance_Sphere(...)')才安全 - 小数位数默认可能被截断，可在 SQL 里用
round(ST_Distance_Sphere(...), 0)控制精度，避免前端拿到 1234.9999999999998 这种值
为什么用 TP 的 scope 查询附近时总查不到数据
八成是坐标顺序搞反了，或者单位没统一。MySQL 的 POINT(x y) 是 lng lat，而人眼习惯看“纬度, 经度”，一抄就错。
立即学习“PHP免费学习笔记（深入）”；
- 检查你的
point(?, ?)两个问号：第一个必须是经度（lng），第二个是纬度（lat） - 确认数据库存的是 WGS-84 坐标（GPS 设备原始值），不是 GCJ-02（高德/腾讯）或 BD-09（百度）——混用会导致偏差超 1km
- 测试时用已知坐标的两点硬编码进 SQL，比如北京西站（39.9042, 116.3350）和北京南站（39.8692, 116.3700），算出来应该约 5.3km，不对就说明公式或单位错了
- TP 的
whereRaw如果拼接字符串而不是用参数绑定，会触发 SQL 注入风险，也容易因引号或小数点导致语法错误
地理距离这事，坐标系、单位、SQL 函数、TP 参数绑定这四块只要有一块没对齐，结果就不可信。最稳妥的方式是先在 MySQL 客户端里跑通一条原生 SQL，再一点点挪到 ThinkPHP 的查询链里。
