Spring 4与Jackson 2：部分类未使用配置的ObjectMapper问题

以下是导致自定义ObjectMapper仅部分生效、Hibernate实体序列化使用其他实例的常见原因：

1. Hibernate/Spring Data相关自动配置生成了独立ObjectMapper #

Spring Boot的自动配置逻辑中，Hibernate模块、Spring Data JPA或Spring Data REST可能会单独初始化ObjectMapper实例，用来处理实体类的序列化/反序列化，这些实例不会继承你自定义的配置。比如Spring Data REST会维护自己的ObjectMapper来处理REST接口返回的实体数据，若你的实体类上标注了@JsonFilter("myFilter")但这个独立实例未配置对应的FilterProvider，就会触发报错。

2. 消息转换器未正确覆盖默认实例 #

即使你定义了MappingJackson2HttpMessageConverter或Jackson2ObjectMapperBuilder Bean，若没有正确替换掉Spring MVC默认的转换器，部分请求可能仍会使用默认的ObjectMapper处理。比如使用@EnableWebMvc后，默认的转换器列表不会自动被自定义Bean覆盖，需要手动在WebMvcConfigurer的configureMessageConverters方法中清空默认转换器并添加自定义的，或者通过extendMessageConverters调整优先级。

3. 第三方组件或自定义代码创建了独立ObjectMapper #

如果你的项目中存在其他组件（比如日志工具、缓存框架），或者自己的代码中手动new ObjectMapper()来处理Hibernate实体（比如序列化到缓存、打印日志），这些场景下会使用独立的ObjectMapper实例，不会应用你在Spring容器中配置的全局实例。

4. 懒加载触发的特殊序列化逻辑 #

Hibernate实体的懒加载属性在序列化时，若延迟加载触发，可能会触发Hibernate自带的序列化处理逻辑，或者Spring的OpenEntityManagerInViewFilter/拦截器在处理过程中使用了未配置FilterProvider的ObjectMapper实例。

排查步骤： #

• 检查容器中的ObjectMapper实例：在代码中通过ApplicationContext.getBeansOfType(ObjectMapper.class)获取所有实例，查看每个实例的来源（是自定义Bean还是自动配置生成），确认是否存在多个实例。
• 定位序列化触发场景：确认报错是在API响应返回时触发，还是在其他逻辑（如缓存、日志）中触发。若为后者，排查对应逻辑中使用的ObjectMapper来源。
• 显式配置FilterProvider：在自定义ObjectMapper中强制添加FilterProvider配置：

  @Bean
  public ObjectMapper objectMapper() {
      SimpleFilterProvider filterProvider = new SimpleFilterProvider()
          .addFilter("myFilter", SimpleBeanPropertyFilter.serializeAll());
      return new ObjectMapper()
          .setFilterProvider(filterProvider)
          .enable(SerializationFeature.INDENT_OUTPUT);
  }
  

  然后跟踪该实例是否被用于Hibernate实体的序列化。
• 调整消息转换器优先级：实现WebMvcConfigurer，在configureMessageConverters中替换默认转换器：

  @Configuration
  public class WebConfig implements WebMvcConfigurer {
      @Autowired
      private ObjectMapper customObjectMapper;
  
      @Override
      public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
          converters.clear();
          MappingJackson2HttpMessageConverter converter = new MappingJackson2HttpMessageConverter(customObjectMapper);
          converters.add(converter);
      }
  }
  

• 检查Spring Data REST配置：若使用Spring Data REST，需通过RepositoryRestConfigurer配置其ObjectMapper：

  @Configuration
  public class RestConfig implements RepositoryRestConfigurer {
      @Autowired
      private ObjectMapper customObjectMapper;
  
      @Override
      public void configureJacksonObjectMapper(ObjectMapper objectMapper) {
          objectMapper.setFilterProvider(customObjectMapper.getFilterProvider());
          objectMapper.enable(SerializationFeature.INDENT_OUTPUT);
      }
  }
  

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