Spring Boot中两个MappingJackson2HttpMessageConverter实例重复问题求助

我之前也踩过一模一样的坑！明明上下文里查不到重复的Bean，但Web MVC的消息转换器列表里就是莫名其妙多了个默认的Jackson实例，导致自定义的序列化配置完全不生效。下面给你拆解问题根源和可行的解决方案：

问题核心原因 #

这种情况大概率是Spring Boot自动配置与自定义配置的加载逻辑冲突导致的：虽然你只注册了一个MappingJackson2HttpMessageConverter Bean，但Web MVC初始化时会先自动添加一个默认转换器，之后你的自定义配置如果只是新增而非替换默认实例，就会出现两个转换器共存的情况——而默认转换器会优先处理请求/响应，你的自定义配置自然就被忽略了。

针对性解决方案 #

方案1：通过WebMvcConfigurer替换默认转换器（最推荐） #

不要直接注册MappingJackson2HttpMessageConverter Bean，而是实现WebMvcConfigurer接口，主动替换掉默认的Jackson转换器：

@Configuration
public class CustomWebMvcConfig implements WebMvcConfigurer {

    private final ObjectMapper customObjectMapper;

    // 注入你自定义的ObjectMapper
    public CustomWebMvcConfig(ObjectMapper customObjectMapper) {
        this.customObjectMapper = customObjectMapper;
    }

    @Override
    public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
        // 先移除所有默认的Jackson转换器
        converters.removeIf(converter -> converter instanceof MappingJackson2HttpMessageConverter);
        // 添加我们自定义的转换器实例
        converters.add(new MappingJackson2HttpMessageConverter(customObjectMapper));
    }
}

这种方式能确保消息转换器列表里只有你配置的那一个实例，彻底避免重复。

方案2：禁用Jackson自动配置，手动完全接管 #

如果上面的方法没解决问题，可以直接禁用Spring Boot的Jackson自动配置，完全手动注册相关Bean：

@SpringBootApplication(exclude = {JacksonAutoConfiguration.class})
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

然后在配置类里手动创建ObjectMapper和转换器：

@Configuration
public class JacksonConfig {
    @Bean
    public ObjectMapper customObjectMapper() {
        ObjectMapper mapper = new ObjectMapper();
        // 这里添加你的自定义配置，比如：
        mapper.setSerializationInclusion(JsonInclude.Include.NON_NULL);
        mapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
        // 其他序列化/反序列化规则...
        return mapper;
    }

    @Bean
    public MappingJackson2HttpMessageConverter mappingJackson2HttpMessageConverter(ObjectMapper objectMapper) {
        return new MappingJackson2HttpMessageConverter(objectMapper);
    }
}

这个方法比较彻底，能完全规避自动配置带来的隐藏冲突。

方案3：排查第三方依赖的额外注入 #

如果你的项目引入了Spring Data REST、Spring Security这类starter，它们可能会悄悄注册自己的Jackson转换器。可以通过调试WebMvcConfigurationSupport的addDefaultHttpMessageConverters方法，追踪是谁在添加额外的转换器。比如Spring Data REST会通过RepositoryRestMvcConfiguration注册专属转换器，这时你需要在对应的配置类中指定使用你的自定义ObjectMapper。

验证方法 #

修改配置后，你可以在控制器里注入RequestMappingHandlerAdapter，打印消息转换器列表确认结果：

@RestController
public class ConverterCheckController {

    @Autowired
    private RequestMappingHandlerAdapter handlerAdapter;

    @GetMapping("/check-converters")
    public String checkConverters() {
        List<HttpMessageConverter<?>> converters = handlerAdapter.getMessageConverters();
        for (HttpMessageConverter<?> converter : converters) {
            if (converter instanceof MappingJackson2HttpMessageConverter) {
                MappingJackson2HttpMessageConverter jacksonConverter = (MappingJackson2HttpMessageConverter) converter;
                System.out.println("Jackson转换器实例：" + jacksonConverter);
                System.out.println("关联的ObjectMapper：" + jacksonConverter.getObjectMapper());
            }
        }
        return "请查看控制台输出";
    }
}

访问接口后，控制台应该只输出一个Jackson转换器实例，且对应的ObjectMapper是你自定义的那一个。

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