Laravel地理位置查询按距离排序报MariaDB语法错误如何解决？

错误原因 #

该1064SQL语法错误的核心问题是距离计算表达式中POW函数的参数、括号位置书写错误：
MariaDB中POW()函数要求传入2个参数，格式为POW(底数, 指数)。你代码中第一个POW的右括号位置错误，将原本应该作为POW第二个参数的2，和第二个POW表达式放在了同一组参数内，导致SQL解析器无法识别语法。

从报错信息提取的生成后SQL片段可以直观看到错误：

POW(69.1 * (latitude - -23.5630907), 2 + POW(69.1 * (-46.6682795 - longitude) * COS(latitude / 57.3), 2)

此处第一个POW实际仅传入1个完整参数，第二个参数变成了非法的2 + POW(...)结构，直接触发语法报错。

解决方法 #

基础修复方案 #

调整括号位置保证两个POW函数参数正确，同时使用参数绑定替代直接拼接坐标变量，避免SQL注入风险，修正后代码如下：

$barbers = Barber::selectRaw('*, SQRT(
    POW(69.1 * (latitude - ?), 2) + 
    POW(69.1 * (? - longitude) * COS(latitude / 57.3), 2)
) AS distance', [$lat, $lng])
->orderBy('distance', 'ASC')
->get();

这里也用Laravel原生的selectRaw方法替代了select(Model::raw())的写法，语法更简洁规范。

性能优化方案（可选） #

如果理发师表数据量较大，全表计算距离会导致查询变慢，可以提前添加坐标范围过滤缩小计算范围，示例如下：

// 定义查询半径，单位为公里
$searchRadius = 20;
// 计算经纬度的过滤范围
$latOffset = $searchRadius / 111;
$lngOffset = $searchRadius / (111 * cos($lat / 57.3));

$barbers = Barber::selectRaw('*, SQRT(
    POW(69.1 * (latitude - ?), 2) + 
    POW(69.1 * (? - longitude) * COS(latitude / 57.3), 2)
) AS distance', [$lat, $lng])
->whereBetween('latitude', [$lat - $latOffset, $lat + $latOffset])
->whereBetween('longitude', [$lng - $lngOffset, $lng + $lngOffset])
->orderBy('distance', 'ASC')
->get();

内容的提问来源于stack exchange，提问作者Pedro Gonçalves