Spring Boot 3.0.2自定义Jackson序列化器未生效问题求助

可能的替代解决方法 #

1. 标记自定义ObjectMapper为@Primary #

Spring Boot中Web层默认使用的ObjectMapper实例，可能和你通过@Autowired获取的不是同一个。你可以创建一个包含@JsonComponent组件的ObjectMapper并标记为@Primary，让Web转换器自动复用这个实例：

@Configuration
public class JacksonConfig {
    @Bean
    @Primary
    public ObjectMapper objectMapper(Jackson2ObjectMapperBuilder builder) {
        // builder会自动扫描并注册所有@JsonComponent组件
        return builder.build();
    }
}

这样Web层的MappingJackson2HttpMessageConverter会优先使用这个被标记为Primary的ObjectMapper，自然就能用上你的自定义序列化器。

2. 用Jackson2ObjectMapperCustomizer手动注册序列化器 #

实现Jackson2ObjectMapperCustomizer接口并注册为Bean，Spring Boot会自动将其应用到所有Web相关的ObjectMapper实例上：

@Component
public class FqdnSerializerCustomizer implements Jackson2ObjectMapperCustomizer {
    @Override
    public void customize(ObjectMapper objectMapper) {
        objectMapper.registerModule(new SimpleModule()
                .addSerializer(Fqdn.class, new FqdnSerializer()));
    }
}

这种方式不需要替换整个转换器集合，只需要针对性地给Web用的ObjectMapper添加序列化器，操作更轻量化。

3. 排查WebMvc配置冲突 #

如果你的项目中存在继承WebMvcConfigurationSupport的配置类，会完全覆盖Spring Boot的默认Web配置，导致@JsonComponent的自动注册逻辑失效。此时你需要：

• 改用WebMvcConfigurer接口（而非继承WebMvcConfigurationSupport），保留Spring Boot的自动配置；
• 如果必须使用WebMvcConfigurationSupport，需要在配置类中手动将自定义序列化器注册到Web用的ObjectMapper中：

@Configuration
public class CustomWebMvcConfig extends WebMvcConfigurationSupport {
    @Override
    protected void extendMessageConverters(List<HttpMessageConverter<?>> converters) {
        for (HttpMessageConverter<?> converter : converters) {
            if (converter instanceof MappingJackson2HttpMessageConverter jacksonConverter) {
                jacksonConverter.getObjectMapper()
                        .registerModule(new SimpleModule().addSerializer(Fqdn.class, new FqdnSerializer()));
            }
        }
    }
}

为什么直接注册MappingJackson2HttpMessageConverter Bean没生效？ #

Spring Boot默认会自动创建MappingJackson2HttpMessageConverter实例，并且优先使用自身管理的ObjectMapper。如果你手动创建这个Bean时，没有传入Spring已经注册了@JsonComponent组件的ObjectMapper，那么这个自定义转换器里的ObjectMapper是全新的、不包含你的序列化器的，自然无法生效。正确的做法是在创建Bean时注入Spring管理的ObjectMapper：

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

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