Hibernate Spatial无法识别@Query中的st_dwithin方法求助

问题背景 #

使用Hibernate 6.5，已配置JTS为实体添加Point类型的geom字段，表结构创建正常，但在Spring Data JPA的Repository中通过@Query调用st_dwithin方法时，抛出语义异常：无法将Object类型表达式与Boolean类型比较。

相关代码与配置 #

实体类 #

@Entity
@Table(name = "OBJECTS_TBL")
public class ObjectEntity {
    @Id
    private String objectId;
    
    private String type;
    private String alias;
    private Boolean active;
    private String createdBy;
    private Point geom;
}

生成的表结构 #

Hibernate: 
    create table objects_tbl (
        active boolean,
        creation_timestamp timestamp(6),
        alias varchar(255),
        created_by varchar(255),
        object_id varchar(255) not null,
        type varchar(255),
        geom geometry,
        object_details clob,
        primary key (object_id)
    )

Repository代码 #

public interface ObjectCrud extends JpaRepository<ObjectEntity, String> {
    
    @Query("SELECT o"
            + " FROM ObjectEntity o "
            + "WHERE st_dwithin(o.geom, st_point( :lng , :lat) ,:distance )  = true")
}

报错信息 #

Caused by: java.lang.IllegalArgumentException: org.hibernate.query.SemanticException: Cannot compare left expression of type 'java.lang.Object' with right expression of type 'java.lang.Boolean'

application.properties配置 #

spring.jpa.hibernate.ddl-auto=create-drop
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true
logging.level.org.hibernate.orm.jdbc.bind=trace
logging.level.org.springframework.transaction=trace
logging.level.org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping=trace

spring.h2.console.enabled=true
spring.h2.console.path=/h2-console

Gradle依赖 #

implementation 'org.springframework.boot:spring-boot-starter-web'
implementation 'org.springframework.boot:spring-boot-starter-data-jpa'

implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.5.0'
implementation 'org.springframework.boot:spring-boot-starter-mail'
implementation 'org.locationtech.jts:jts-core:1.19.0'
implementation 'org.hibernate.orm:hibernate-spatial:6.5.2.Final'

runtimeOnly 'com.h2database:h2'
runtimeOnly 'org.postgresql:postgresql'

developmentOnly 'org.springframework.boot:spring-boot-docker-compose'
developmentOnly 'org.springframework.boot:spring-boot-devtools'

testImplementation 'org.springframework.boot:spring-boot-starter-test'

testRuntimeOnly 'org.junit.platform:junit-platform-launcher'

解决方案 #

1. 配置对应数据库的空间方言 #

Hibernate需要通过空间方言来识别空间函数的返回类型，在application.properties中添加以下配置：

• PostgreSQL+PostGIS环境：

  spring.jpa.properties.hibernate.dialect=org.hibernate.spatial.dialect.postgis.PostgisDialect
  

• H2（GeoDB扩展）环境：

  spring.jpa.properties.hibernate.dialect=org.hibernate.spatial.dialect.h2geodb.GeoDBDialect
  

2. 简化JPQL查询语句 #

st_dwithin本身返回布尔值，无需额外与true比较，直接作为WHERE条件即可，同时建议添加@Param注解明确参数绑定：

public interface ObjectCrud extends JpaRepository<ObjectEntity, String> {
    
    @Query("SELECT o FROM ObjectEntity o WHERE st_dwithin(o.geom, st_point(:lng, :lat), :distance)")
    List<ObjectEntity> findObjectsWithinDistance(
        @Param("lng") double lng, 
        @Param("lat") double lat, 
        @Param("distance") double distance
    );
}

原因说明 #

• 未配置空间方言时，Hibernate无法识别st_dwithin这类空间函数的返回类型，默认将其标记为Object，导致与Boolean类型的true比较时触发语义异常。
• 空间方言会告知Hibernate如何解析空间函数，正确识别其返回值为布尔类型，同时确保生成符合数据库要求的空间SQL语句。

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