Spring REST API中如何正确添加自定义HttpMessageConverter？

看起来你遇到的问题主要和Spring处理HttpMessageConverter的逻辑以及你的配置细节有关，我来帮你梳理问题点和修复方案：

问题根源分析 #

1. configureMessageConverters的行为误解
   这个方法的作用是完全替换Spring默认的转换器列表，而非追加自定义实现。你现在只添加了自己的JSON和XML转换器，但没有引入其他必要的默认转换器，可能导致部分请求/响应的MediaType无法匹配，或者自定义转换器没被优先选中。更稳妥的方式是使用extendMessageConverters，它会在默认转换器的基础上添加或修改你的自定义逻辑。

2. MappingJackson2XmlHttpMessageConverter配置冗余
   你代码里同时用了Jackson2ObjectMapperBuilder和手动创建的XmlMapper，最后调用setObjectMapper(xmlMapper)会覆盖builder生成的mapper，这不仅冗余，还可能丢失一些默认配置。

3. 转换器优先级问题
   即便添加了自定义转换器，如果它在列表中的位置靠后，Spring可能会优先使用默认转换器，导致你的序列化/反序列化逻辑不生效。

修复后的配置代码 #

下面是调整后的正确配置，保留了你的自定义序列化/反序列化逻辑，同时解决上述问题：

@Configuration
public class SpringWebConfig implements WebMvcConfigurer {

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(new BodyPrinterInterceptor());
    }

    @Override
    public void extendMessageConverters(List<HttpMessageConverter<?>> converters) {
        // 创建自定义模块，包含你的序列化/反序列化器
        SimpleModule customModule = new SimpleModule("module", new Version(1, 0, 0, null, null, null))
                .addSerializer(LocalDate.class, new LocalDateSerializer())
                .addDeserializer(LocalDate.class, new LocalDateDeserializer())
                .addSerializer(Type2_Numbers.class, new Type2_Numbers_Serializer())
                .addDeserializer(Type2_Numbers.class, new Type2_Numbers_Deserializer());

        // 配置JSON转换器
        MappingJackson2HttpMessageConverter jsonConverter = new MappingJackson2HttpMessageConverter();
        ObjectMapper jsonObjectMapper = new ObjectMapper()
                .enable(SerializationFeature.INDENT_OUTPUT)
                .registerModule(customModule);
        jsonConverter.setObjectMapper(jsonObjectMapper);

        // 配置XML转换器
        MappingJackson2XmlHttpMessageConverter xmlConverter = new MappingJackson2XmlHttpMessageConverter();
        XmlMapper xmlObjectMapper = new XmlMapper()
                .enable(SerializationFeature.INDENT_OUTPUT)
                .registerModule(customModule);
        xmlConverter.setObjectMapper(xmlObjectMapper);

        // 将自定义转换器添加到列表头部，确保优先级高于默认转换器
        converters.add(0, jsonConverter);
        converters.add(1, xmlConverter);
    }
}

关键调整说明 #

• 改用extendMessageConverters：保留Spring默认的所有转换器，同时将自定义转换器插入到列表最前面，保证Spring优先使用你的实现。
• 简化XML转换器配置：直接创建XmlMapper并配置，避免builder和手动setObjectMapper的冲突。
• 明确优先级：通过add(0, ...)和add(1, ...)把自定义转换器放在列表头部，确保它们先被Spring选中处理对应的MediaType。

额外验证步骤 #

1. 确保自定义序列化/反序列化器正确实现了JsonSerializer/JsonDeserializer接口，并且覆盖了serialize/deserialize方法。
2. 检查请求/响应的Content-Type和Accept头是否匹配application/json或application/xml（这是Jackson转换器默认处理的MediaType）。
3. 可以在自定义转换器的canRead/canWrite方法中添加日志，验证Spring是否调用了你的转换器。

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