Spring Boot整合JPA+Hibernate Spatial+PostGIS遇错求助

问题背景 #

在Spring Boot项目中整合JPA、Hibernate Spatial与PostGIS时，遇到两个核心问题：Dialect解析失败、JSON序列化无限递归。相关配置与代码如下：

application.properties配置 #

spring.datasource.url=jdbc:postgresql://localhost:5432/test_postgis
spring.datasource.username=postgres
spring.datasource.password=1234
spring.datasource.driver-class-name=org.postgresql.Driver

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

spring.jpa.hibernate.ddl-auto=update

依赖配置 #

implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
implementation group: 'org.hibernate.orm', name: 'hibernate-spatial', version: '6.5.0.Final'

// 不确定是否必要，加不加都没变化
implementation group: 'org.locationtech.jts', name: 'jts-core', version: '1.19.0'

实体类 #

import org.locationtech.jts.geom.Polygon;

import jakarta.persistence.*;
import lombok.Data;
import lombok.NoArgsConstructor;

@Data
@NoArgsConstructor
@Entity
@Table(name = "GEOM")
public class Geom {
    @Id
    @Column(name = "ID_GEOM")
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Integer id;
    @Column(name = "POLYG", columnDefinition = "geometry(Polygon,4326)")
    private Polygon polyg;
}

数据库表结构 #

CREATE TABLE geom (
    id_geom SERIAL PRIMARY KEY,
    polyg GEOMETRY(POLYGON, 4326)
);

问题1：Dialect解析失败（StrategySelectionException） #

错误信息 #

org.hibernate.boot.registry.selector.spi.StrategySelectionException: 
Unable to resolve name [org.hibernate.spatial.dialect.postgis.PostgisDialect]
as strategy [org.hibernate.dialect.Dialect]

解决步骤 #

1. 统一依赖版本，避免冲突
   Spring Boot的spring-boot-starter-data-jpa自带Hibernate依赖，手动指定hibernate-spatial版本易导致版本不兼容。去掉手动版本号，让Spring Boot自动管理兼容版本：

   implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
   implementation 'org.hibernate.orm:hibernate-spatial'
   implementation 'org.locationtech.jts:jts-core'
   

2. 修正方言类路径
   Hibernate 6.x中PostGIS的方言类路径调整，将配置中的方言改为：

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

   （注：部分Hibernate Spatial 6.x版本仍使用原PostgisDialect路径，若上述无效可改回，但优先保证依赖版本兼容）

问题2：JSON序列化无限递归（StackOverflowError） #

错误信息 #

[nio-8080-exec-3] .w.s.m.s.DefaultHandlerExceptionResolver : Ignoring exception,
response committed already: org.springframework.http.converter.HttpMessageNotWritableException
Could not write JSON: Infinite recursion (StackOverflowError)

返回JSON出现无限嵌套的envelope字段。

解决步骤 #

1. 引入Jackson JTS序列化模块
   添加专门处理JTS几何对象的Jackson依赖，解决自引用序列化问题：

   implementation 'com.bedatadriven:jackson-datatype-jts:2.15.2'
   

   版本需与Spring Boot自带的Jackson版本匹配（比如Spring Boot 3.2.x对应Jackson 2.15.x）。

2. 注册JTS序列化模块
   创建Jackson配置类，注册JTS模块：

   import com.bedatadriven.jackson.datatype.jts.JtsModule;
   import org.springframework.context.annotation.Bean;
   import org.springframework.context.annotation.Configuration;
   import com.fasterxml.jackson.databind.Module;
   
   @Configuration
   public class JacksonConfig {
       @Bean
       public Module jtsModule() {
           return new JtsModule();
       }
   }
   

3. （可选）指定实体类字段的序列化器
   在实体类的Polygon字段上添加序列化/反序列化注解，确保正确解析：

   import com.bedatadriven.jackson.datatype.jts.serialization.GeometrySerializer;
   import com.bedatadriven.jackson.datatype.jts.serialization.GeometryDeserializer;
   import com.fasterxml.jackson.databind.annotation.JsonSerialize;
   import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
   
   // ...
   
   @Column(name = "POLYG", columnDefinition = "geometry(Polygon,4326)")
   @JsonSerialize(using = GeometrySerializer.class)
   @JsonDeserialize(using = GeometryDeserializer.class)
   private Polygon polyg;
   

内容的提问来源于stack exchange，提问作者Vítor Fraporti Rosmann