Spring环境下配置Jackson DeserializationProblemHandler实现宽松反序列化

我完全理解你的需求——不想重新创建Jackson ObjectMapper Bean，而是基于Spring已经自动配置好的实例做自定义，并且要实现“某个属性反序列化抛异常时，把该属性设为null，让整个反序列化流程继续执行”的宽松特性。下面给你两种可行的实现方案：

方案一：利用Jackson内置特性（快速适配常见场景） #

如果你的需求主要是处理未知属性或者枚举类型反序列化失败这类常见情况，直接用Jackson的内置配置就能搞定：

@Bean
public Jackson2ObjectMapperBuilderCustomizer jacksonLooseDeserializerCustomizer() {
    return builder -> builder
        // 忽略JSON中存在但实体类未定义的属性，避免因未知属性中断反序列化
        .failOnUnknownProperties(false)
        // 将无法匹配的枚举值自动反序列化为null
        .featuresToEnable(DeserializationFeature.READ_UNKNOWN_ENUM_VALUES_AS_NULL);
}

方案二：自定义反序列化异常处理器（覆盖通用场景） #

如果需要处理更通用的情况——比如已知属性类型不匹配（比如Integer字段传入了字符串）导致的反序列化失败，就需要自定义一个DeserializationProblemHandler来捕获异常，返回null并让流程继续：

步骤1：实现自定义异常处理器 #

这个处理器会捕获各类反序列化异常，并针对失败的属性返回null：

import com.fasterxml.jackson.core.JsonParser;
import com.fasterxml.jackson.databind.DeserializationContext;
import com.fasterxml.jackson.databind.deser.DeserializationProblemHandler;
import java.io.IOException;

public class NullOnFailureHandler extends DeserializationProblemHandler {

    // 处理类型不匹配的异常（比如字符串转数字失败）
    @Override
    public Object handleUnexpectedToken(DeserializationContext ctxt, Class<?> targetType, JsonParser p, String failureMsg) throws IOException {
        return null;
    }

    // 处理对象实例化失败的异常
    @Override
    public Object handleInstantiationProblem(DeserializationContext ctxt, Class<?> instClass, Object value, Throwable cause) throws IOException {
        return null;
    }

    // 可以根据业务需求，重写更多异常处理方法覆盖不同场景
}

步骤2：通过Jackson2ObjectMapperBuilder注册处理器 #

用Jackson2ObjectMapperBuilderCustomizer来修改Spring自动配置的ObjectMapper，不会新建Bean，完全符合你的复用要求：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import com.fasterxml.jackson.databind.DeserializationFeature;
import org.springframework.http.converter.json.Jackson2ObjectMapperBuilder;

@Configuration
public class JacksonCustomConfig {

    @Bean
    public Jackson2ObjectMapperBuilderCustomizer jacksonCustomizer() {
        return builder -> builder
            // 先开启基础宽松配置
            .failOnUnknownProperties(false)
            .featuresToEnable(DeserializationFeature.READ_UNKNOWN_ENUM_VALUES_AS_NULL)
            // 注册自定义的异常处理器
            .postConfigurer(objectMapper -> {
                objectMapper.addHandler(new NullOnFailureHandler());
            });
    }
}

补充说明 #

• 方案一适合快速解决常见的宽松反序列化需求，代码量少；
• 方案二更灵活，能处理几乎所有类型的属性反序列化失败场景，你可以根据实际业务需求扩展NullOnFailureHandler里的方法；
• 两种方案都是基于Jackson2ObjectMapperBuilderCustomizer实现的，这是Spring官方推荐的修改自动配置ObjectMapper的方式，完全不会新建Bean，完美匹配你“复用现有实例”的要求。

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