Laravel中MySQL原生JSON地理查询转PostgreSQL语法及JSON路径语法名称咨询

AI 小北

2026-4-30

解答你的PostgreSQL JSON与空间查询适配问题

1. 这种`$. <json key>`形式的语法名称是什么？

这是MySQL的JSON Path表达式，搭配->>操作符使用——->>在MySQL里是JSON_UNQUOTE(JSON_EXTRACT(column, path))的简写，作用是从JSON类型字段中提取指定路径的属性并自动去除引号。这里的$.longitude就是标准的JSON Path写法，$代表JSON对象的根节点，.longitude表示读取根节点下的longitude属性。

2. 转换为PostgreSQL兼容的查询语法

PostgreSQL对JSON/JSONB类型的操作逻辑、空间函数实现和MySQL有明显差异（需要依赖PostGIS扩展，Heroku PostgreSQL默认支持，你可以确认下实例是否已启用），具体转换如下：

第一步：JSON属性提取的适配

PostgreSQL中，从JSONB字段（推荐用JSONB而非原生JSON，查询性能更强）提取文本属性，直接用->>操作符加键名即可，不需要JSON Path的$前缀：

MySQL写法：address->>"$.longitude"
PostgreSQL写法：address->>'longitude'

如果偏好JSON Path语法，PostgreSQL也支持用#>>操作符配合数组格式的路径，比如address#>>'{longitude}'，但前者更简洁常用。

第二步：空间距离函数的替换

MySQL的ST_Distance_Sphere计算球面距离（单位为米），PostgreSQL（PostGIS）中需要先将坐标转为GEOGRAPHY地理类型，再用ST_Distance计算，结果同样以米为单位。之后按照你原逻辑乘以0.000621371192转换为英里即可。

最终Laravel原生查询代码

$query->whereRaw('
    ST_Distance(
        ST_MakePoint(address->>\'longitude\', address->>\'latitude\')::GEOGRAPHY,
        ST_MakePoint(?, ?)::GEOGRAPHY
    ) * 0.000621371192 < ?
', [$longitude, $latitude, $distance]);

额外注意：确保你的address字段在PostgreSQL中是JSONB类型（JSON类型也能工作，但JSONB支持索引，更适合频繁查询的场景）；如果你的Heroku数据库实例未启用PostGIS，可通过Heroku CLI执行命令启用：heroku pg:psql -c "CREATE EXTENSION postgis;"

另外，如果到周三还没搞定，切换回MySQL确实是个低风险的备选方案，毕竟你提到对业务影响不大。

内容的提问来源于stack exchange，提问作者Purplenimbus