如何通过Jackson2ObjectMapperBuilderCustomizer配置Retrofit2的Jackson反序列化器

你遇到的核心问题是：Retrofit2默认不会自动使用Spring容器中被Jackson2ObjectMapperBuilderCustomizer定制过的ObjectMapper。虽然你正确定义了Jackson2ObjectMapperBuilderCustomizer Bean，它会作用于Spring管理的ObjectMapper实例，但Retrofit默认创建的JacksonConverterFactory会使用自己全新的、未被定制的ObjectMapper，导致全局配置不生效，出现LocalDateTime反序列化错误。

要让Retrofit复用Spring全局配置的ObjectMapper，核心思路是：让Retrofit使用Spring容器中已经被Jackson2ObjectMapperBuilderCustomizer定制好的ObjectMapper实例，而非自己创建默认实例。具体实现步骤如下：

1. 保持Jackson2ObjectMapperBuilderCustomizer的配置 #

先确保你的全局Jackson定制Bean正确配置，比如针对LocalDateTime的序列化/反序列化规则：

@Bean
public Jackson2ObjectMapperBuilderCustomizer jacksonDateTimeCustomizer() {
    return builder -> {
        DateTimeFormatter dateTimeFormatter = DateTimeFormatter.ISO_LOCAL_DATE_TIME;
        builder.deserializerByType(LocalDateTime.class, new LocalDateTimeDeserializer(dateTimeFormatter));
        builder.serializerByType(LocalDateTime.class, new LocalDateTimeSerializer(dateTimeFormatter));
        // 可添加其他全局配置，比如忽略未知字段、日期格式统一等
        builder.failOnUnknownProperties(false);
    };
}

2. 配置Spring管理的JacksonConverterFactory #

在Spring容器中创建JacksonConverterFactory Bean，直接使用Spring已经定制好的ObjectMapper：

@Bean
public JacksonConverterFactory jacksonConverterFactory(ObjectMapper objectMapper) {
    return JacksonConverterFactory.create(objectMapper);
}

注：Spring Boot会自动将Jackson2ObjectMapperBuilderCustomizer的配置应用到容器内的ObjectMapper实例，所以这里注入的objectMapper已经包含了你定义的全局规则。

3. 统一创建Retrofit实例（复用全局转换器） #

定义一个全局的Retrofit Bean，注入上面的JacksonConverterFactory，避免每次创建RetrofitBuilder都重复配置：

@Bean
public Retrofit retrofit(JacksonConverterFactory jacksonConverterFactory) {
    OkHttpClient okHttpClient = new OkHttpClient.Builder()
            // 可添加OkHttp的全局配置，比如超时、拦截器等
            .connectTimeout(30, TimeUnit.SECONDS)
            .build();

    return new Retrofit.Builder()
            .baseUrl("https://your-remote-api-base-url.com/")
            .addConverterFactory(jacksonConverterFactory)
            .client(okHttpClient)
            .build();
}

4. 使用Retrofit实例 #

在需要调用远程服务的地方，直接注入Retrofit实例创建API接口代理即可：

@Service
public class RemoteServiceClient {
    private final YourApiInterface yourApi;

    // 构造注入Retrofit实例，创建API代理
    public RemoteServiceClient(Retrofit retrofit) {
        this.yourApi = retrofit.create(YourApiInterface.class);
    }

    // 调用远程接口的方法
    public void callRemoteApi() {
        Call<YourResponse> call = yourApi.getData();
        // 处理请求逻辑
    }
}

• 为什么之前的配置不生效？：Retrofit的JacksonConverterFactory.create()静态方法默认会新建一个未被Spring定制的ObjectMapper，完全独立于Spring容器的Bean，所以Jackson2ObjectMapperBuilderCustomizer的配置无法作用于它。
• 优势：通过Spring统一管理Retrofit和JacksonConverterFactory，不仅避免了重复配置，还能确保所有Retrofit请求都复用同一套全局Jackson规则，维护性更强。

内容的提问来源于stack exchange，提问作者Flavian-Calinic Stuparu