如何通过JsonMapper.Builder配置Jackson全局默认反序列化子类型

这个需求我之前也碰到过——没法修改第三方提供的抽象类/接口源码，又想让Jackson全局默认用指定的子类来反序列化它们，完全不用在每个字段上加注解。其实用Jackson自带的SimpleTypeResolver和TypeResolverBuilder就能轻松搞定，下面我一步步给你讲具体怎么做。

核心思路 #

Jackson的SimpleTypeResolver允许我们全局注册「目标类型→默认实现类」的映射关系，效果和在父类上添加@JsonDeserialize(as=XXX.class)完全一致，但它是全局生效的，不管反序列化的上下文是什么场景。我们只需要把这个resolver配置到JsonMapper.Builder里就行。

具体代码实现 #

1. 注册类型映射规则

首先创建SimpleTypeResolver实例，把你需要的类型映射加进去：

import com.fasterxml.jackson.databind.type.SimpleTypeResolver;
import java.lang.Number;
import java.math.BigDecimal;

SimpleTypeResolver typeResolver = new SimpleTypeResolver();
// 规则1：当反序列化目标是Number时，自动用BigDecimal处理
typeResolver.addMapping(Number.class, BigDecimal.class);
// 规则2：当反序列化目标是第三方Person接口时，自动用自定义的Neighbor实现类
typeResolver.addMapping(com.example.thirdparty.Person.class, com.example.mycustom.Neighbor.class);

2. 构建TypeResolverBuilder

接下来把上面的resolver关联到TypeResolverBuilder中，这里我们用DefaultTypeResolverBuilder：

import com.fasterxml.jackson.databind.jsontype.DefaultTypeResolverBuilder;
import com.fasterxml.jackson.databind.jsontype.DefaultTyping;

TypeResolverBuilder<?> typeResolverBuilder = new DefaultTypeResolverBuilder.DefaultTypeResolverBuilder(DefaultTyping.NON_FINAL)
        .init(null, null) // 这里不需要类型ID，因为我们是强制指定实现类
        .typeResolver(typeResolver);

3. 配置到JsonMapper.Builder并构建ObjectMapper

最后把这个builder配置到JsonMapper.Builder里，生成最终的ObjectMapper：

import com.fasterxml.jackson.databind.json.JsonMapper;

JsonMapper objectMapper = JsonMapper.builder()
        .typeResolverBuilder(typeResolverBuilder)
        .build();

注意事项 #

• 如果你用的是record类型（比如你的Neighbor），要确保它的构造参数和JSON中的字段名匹配，Jackson默认会自动适配record的全参构造方法，一般不用额外配置。
• 这种全局配置是优先级很高的，只要反序列化的目标类型是你注册的抽象类/接口，就会强制用指定的实现类，所以要确认这个规则符合你所有的业务场景。
• 如果后续需要添加更多的类型映射，直接在typeResolver上继续调用addMapping就行。

这样配置之后，不管是直接反序列化Number类型，还是处理涉及Person接口的反序列化场景，Jackson都会自动用你指定的实现类来处理，完全不用修改第三方或抽象类的源码。

内容来源于stack exchange