Micronaut框架中Hibernate Spatial Geometry类型序列化反序列化问题

核心问题根源 #

你碰到的问题本质是三个关键配置缺失或错误：

• 未指定PostGIS方言，导致Hibernate无法识别PostgreSQL的geometry字段类型，查询时触发反序列化失败
• Micronaut的ObjectMapper默认未注册JTS几何类型的序列化模块，且Spring的GeoModule不适用于Micronaut环境
• 自定义AttributeConverter未适配Hibernate的类型映射逻辑，保存时把Point转为字符串，触发SQL类型不匹配错误

分步解决方案 #

1. 配置PostGIS方言（必做） #

Hibernate Spatial 6.x必须明确指定PostGIS方言，才能正确处理PostGIS的geometry类型。在application.yml中添加配置：

jpa:
  default:
    properties:
      hibernate:
        dialect: org.hibernate.spatial.dialect.postgis.PostgisDialect

如果用properties格式：

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

这是基础配置，没有正确的方言，Hibernate无法解析数据库的geometry字段，后续所有类型处理都会失效。

2. 给Micronaut Jackson注册JTS序列化模块 #

Micronaut的ObjectMapper不会自动识别JTS类型，需手动注册模块。首先添加依赖（版本和项目Jackson版本匹配即可）：

// build.gradle
implementation 'com.bedatadriven:jackson-datatype-jts:2.15.2'

然后通过Factory类注册JtsModule Bean，让Micronaut自动加载：

import com.bedatadriven.jackson.datatype.jts.JtsModule;
import io.micronaut.context.annotation.Bean;
import io.micronaut.context.annotation.Factory;

@Factory
public class JacksonJtsConfig {
    @Bean
    public JtsModule jtsModule() {
        return new JtsModule();
    }
}

完成后，Micronaut的Jackson就能正确序列化/反序列化Point等JTS几何类型。

3. 移除自定义AttributeConverter #

配置好方言后，Hibernate Spatial会自动处理Point与数据库geometry类型的双向映射，无需自定义转换器。保留转换器反而会导致保存时把Point转为字符串，触发"column is of type geometry but expression is of type character varying"错误。

4. 优化实体类字段配置（可选） #

建议在@Column中指定坐标系SRID（比如4326代表WGS84全球坐标系），让数据库字段定义更明确：

import org.locationtech.jts.geom.Point;
import jakarta.persistence.Column;
import jakarta.persistence.Entity;
import jakarta.persistence.Id;

@Entity
public class Location {
    @Id
    private Long id;

    @Column(columnDefinition = "geometry(Point,4326)")
    private Point point;

    // getter、setter略
}

验证效果 #

• 查询现有记录：Hibernate会通过PostgisDialect正确反序列化geometry字段为Point对象
• 保存新实体：Hibernate自动将Point转换为数据库可识别的geometry类型，不会再出现SQL语法错误

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