Spring Boot整合PostGIS使用ST_GeomFromText时几何结构无效问题

问题描述 #

使用Spring Boot结合Hibernate JPA操作PostGIS时，仓库层代码执行报错，但直接在PostgreSQL中运行等价的硬坐标查询可正常返回结果。

仓库层代码 #

@Query(value = "select {h-schema}ref_plz_geom.plz from {h-schema}ref_plz_geom WHERE ST_Contains(geom, ST_Transform(ST_GeomFromText('POINT(:userLongitude :userLatitude)',4647),4326))", nativeQuery=true)
String getPlz(Double userLongitude, Double userLatitude);

报错信息 #

2023-01-10 14:44:08,479 ERROR org.hibernate.engine.jdbc.spi.SqlExceptionHelper - ERROR: parse error - invalid geometry
  Hint: "POINT(:u" <-- parse error at position 8 within geometry

可正常执行的PostgreSQL原生查询 #

select
        pincode 
    from
        pin_code_table
    WHERE
        ST_Contains(geom, ST_Transform(ST_GeomFromText('POINT(32528808.761501245 5471624.355)',4647),4326))

问题原因 #

JPA无法解析被单引号包裹的字符串内部的参数占位符:userLongitude和:userLatitude，会将整个'POINT(:userLongitude :userLatitude)'视为常量字符串传递给PostGIS，导致PostGIS接收到包含:u的无效几何表达式，触发解析错误。

解决方法 #

方法1：使用PostGIS原生函数构造几何（推荐） #

用ST_MakePoint直接接收坐标参数，配合ST_SetSRID指定坐标系，完全避免字符串拼接占位符的问题：

@Query(value = "select {h-schema}ref_plz_geom.plz from {h-schema}ref_plz_geom WHERE ST_Contains(geom, ST_Transform(ST_SetSRID(ST_MakePoint(:userLongitude, :userLatitude), 4647), 4326))", nativeQuery = true)
String getPlz(Double userLongitude, Double userLatitude);

这种方式符合SQL参数绑定规范，无SQL注入风险，性能更优。

方法2：使用SpEL表达式动态拼接坐标字符串 #

如果必须使用ST_GeomFromText，可以通过Hibernate支持的SpEL表达式将参数值直接插入SQL字符串：

@Query(value = "select {h-schema}ref_plz_geom.plz from {h-schema}ref_plz_geom WHERE ST_Contains(geom, ST_Transform(ST_GeomFromText('POINT(' || :#{#userLongitude} || ' ' || :#{#userLatitude} || ')',4647),4326))", nativeQuery=true)
String getPlz(Double userLongitude, Double userLatitude);

注意：使用此方法需确保参数值可信，避免SQL注入风险。

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