Spring Boot中PostGIS区域点位查询@Query报错问题求助

嘿，这个问题我之前踩过一模一样的坑！咱们来拆解一下为啥会报错，以及怎么解决：

报错原因分析 #

你遇到的QuerySyntaxException: unexpected AST node: (错误，根源在于HQL的语法解析器不认识PostGIS函数里嵌套的WKT字符串格式：

• 第二个能正常运行的查询用的是ST_MakePoint(?1, ?2)，参数是占位符，HQL解析器只把它当成普通的函数调用，不会去解析参数内容；
• 而第一个查询里的ST_MakePolygon('LINESTRING(...)')，硬写的WKT字符串里包含了大量括号，HQL解析器会错误地把这些括号当成HQL的语法结构（比如表达式分组），导致AST（抽象语法树）解析失败；
• 至于pgAdmin里能运行，是因为直接执行的是原生SQL，PostgreSQL的PostGIS扩展能直接识别WKT格式，不需要经过HQL的解析。

解决办法 #

这里有几个靠谱的解决方案，你可以根据自己的需求选择：

方案1：改用原生SQL查询（最直接） #

在@Query注解里加上nativeQuery=true，让Spring直接把SQL交给PostgreSQL执行，绕过HQL的解析步骤：

@Query(value = "SELECT w.* FROM ${WalkEntity.TABLE_NAME} AS w WHERE ST_Within(w.start_point, ST_MakePolygon('LINESTRING(41.15294130710586 113.20090225705104, 41.15294130710586 115.97018471050012, 37.53742712587926 115.97018471050012, 37.53742712587926 113.20090225705104, 41.15294130710586 113.20090225705104)')) AND w.visibility=0 AND w.state=0 ORDER BY w.start_time DESC", nativeQuery = true)
fun findInArea(): List<WalkEntity>

方案2：将WKT字符串作为参数传递（保持HQL风格） #

把硬写的LINESTRING字符串改成参数占位符，让HQL解析器不会去解析WKT内部的结构：

@Query("SELECT w FROM ${WalkEntity.TABLE_NAME} AS w WHERE ST_Within(w.start_point, ST_MakePolygon(:wkt)) AND w.visibility=0 AND w.state=0 ORDER BY w.start_time DESC")
fun findInArea(@Param("wkt") wkt: String): List<WalkEntity>

调用时传入WKT字符串即可：

val areaWkt = "LINESTRING(41.15294130710586 113.20090225705104, 41.15294130710586 115.97018471050012, 37.53742712587926 115.97018471050012, 37.53742712587926 113.20090225705104, 41.15294130710586 113.20090225705104)"
val result = walkRepository.findInArea(areaWkt)

方案3：使用Hibernate Spatial的API构建几何对象（更优雅） #

如果你的项目已经引入了Hibernate Spatial依赖，可以直接用它的API构建Polygon对象，避免手写WKT：

// 先构建多边形的坐标点（注意WKT是先经度后纬度）
val point1 = org.locationtech.jts.geom.Coordinate(113.20090225705104, 41.15294130710586)
val point2 = org.locationtech.jts.geom.Coordinate(115.97018471050012, 41.15294130710586)
val point3 = org.locationtech.jts.geom.Coordinate(115.97018471050012, 37.53742712587926)
val point4 = org.locationtech.jts.geom.Coordinate(113.20090225705104, 37.53742712587926)
val point5 = point1 // 闭合多边形需要首尾点相同

// 创建Polygon对象
val geometryFactory = org.locationtech.jts.geom.GeometryFactory()
val areaPolygon = geometryFactory.createPolygon(arrayOf(point1, point2, point3, point4, point5))

// 查询方法定义
@Query("SELECT w FROM ${WalkEntity.TABLE_NAME} AS w WHERE ST_Within(w.start_point, :polygon) AND w.visibility=0 AND w.state=0 ORDER BY w.start_time DESC")
fun findInArea(@Param("polygon") polygon: org.locationtech.jts.geom.Polygon): List<WalkEntity>

额外注意事项 #

• 确保WalkEntity里的start_point字段正确映射PostGIS几何类型：

  @Column(columnDefinition = "geometry(Point, 4326)")
  var start_point: org.locationtech.jts.geom.Point? = null
  

• 如果用方案3，确认项目引入了Hibernate Spatial依赖（版本要和你的hibernate-core一致）：

  <dependency>
      <groupId>org.hibernate</groupId>
      <artifactId>hibernate-spatial</artifactId>
      <version>5.4.6.Final</version>
  </dependency>
  

• 检查PostgreSQL数据库已启用PostGIS扩展：

  CREATE EXTENSION IF NOT EXISTS postgis;
  

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