Hibernate 6中含Instant的JSON类型无法序列化问题排查

核心原因分析 #

1. Hibernate 6 JSON序列化机制的独立特性 #

Hibernate 6对JSON类型的处理不再直接复用Spring容器中的ObjectMapper实例，而是默认使用自身封装的Jackson集成逻辑。即使通过HibernatePropertiesCustomizer注入自定义ObjectMapper，Hibernate也不会自动关联到JSON序列化流程中——它需要的是指定**格式映射器（FormatMapper）**而非原始的ObjectMapper。

2. 错误的属性配置方式 #

如果你的HibernatePropertiesCustomizer只是简单地将自定义ObjectMapper设置到某个属性中，这完全不符合Hibernate 6的配置要求。正确的做法是配置hibernate.type.json_format_mapper属性，指向一个实现了JsonFormatMapper的Bean，而非直接传递ObjectMapper。

3. Spring Boot自动配置的初始化顺序问题 #

Spring Boot在启动时会优先完成Hibernate核心组件的初始化，若你的HibernatePropertiesCustomizer配置时机晚于Hibernate类型映射的初始化阶段，自定义配置就无法覆盖默认逻辑，导致无效。

正确的配置方式 #

方式一：通过HibernatePropertiesCustomizer指定格式映射器 #

先创建一个基于自定义ObjectMapper的JacksonJsonFormatMapper：

@Component
public class CustomJacksonJsonFormatMapper extends JacksonJsonFormatMapper {
    public CustomJacksonJsonFormatMapper(ObjectMapper objectMapper) {
        super(objectMapper);
    }
}

然后在HibernatePropertiesCustomizer中配置该映射器：

@Component
public class HibernateJsonConfig implements HibernatePropertiesCustomizer {
    private final CustomJacksonJsonFormatMapper customJsonFormatMapper;

    public HibernateJsonConfig(CustomJacksonJsonFormatMapper customJsonFormatMapper) {
        this.customJsonFormatMapper = customJsonFormatMapper;
    }

    @Override
    public void customize(Map<String, Object> hibernateProperties) {
        hibernateProperties.put("hibernate.type.json_format_mapper", customJsonFormatMapper);
    }
}

方式二：直接注册JsonFormatMapper为Bean #

Hibernate 6会自动拾取容器中类型为JsonFormatMapper的Bean，因此只需将自定义的JacksonJsonFormatMapper注册为Bean即可：

@Bean
public JsonFormatMapper jsonFormatMapper(ObjectMapper objectMapper) {
    return new JacksonJsonFormatMapper(objectMapper);
}

这种方式无需使用HibernatePropertiesCustomizer，更简洁直接。

为什么临时方案（实现FormatMapper）可行 #

你临时实现的FormatMapper直接注册到了Hibernate的类型处理体系中，绕过了Spring Boot自动配置的顺序问题，同时直接对接了Hibernate的JSON序列化流程，因此能生效，但缺点是重复了ObjectMapper的配置逻辑。

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