Jackson如何将含缺失字段的JSON反序列化为POJO？

问题场景 #

你有两种JSON数据：

{
    "name" : "tom",
    "age" : 10
}

部分JSON会额外包含address字段。尝试反序列化为以下POJO时失败：

public class StudentDetails {

    @NonNull
    private final String name;

    @NonNull
    private final int age;

    private final String address;

}

你已经试过@NonNull、@Nullable、@JsonInclude、@JsonIgnoreProperties、Optional<>等方式，但都没解决问题。

核心原因 #

你的POJO字段都是final修饰，Jackson无法通过无参构造+字段赋值的方式初始化对象，必须依赖匹配的带参构造方法，同时需要明确指定JSON字段与构造方法参数的映射关系，否则Jackson无法正确处理可选字段的缺失情况。

解决方案 #

1. 添加带参构造方法，配合@JsonCreator和@JsonProperty注解 #

这是最直接的解决方式，通过构造方法注入所有字段，可选字段address在JSON缺失时会被传入null：

import com.fasterxml.jackson.annotation.JsonCreator;
import com.fasterxml.jackson.annotation.JsonProperty;
import org.jetbrains.annotations.NotNull;

public class StudentDetails {

    @NotNull
    private final String name;

    @NotNull
    private final int age;

    private final String address;

    // 标记Jackson要使用的构造方法
    @JsonCreator
    public StudentDetails(
            // 指定对应JSON中的字段名
            @JsonProperty("name") @NotNull String name,
            @JsonProperty("age") @NotNull int age,
            @JsonProperty("address") String address) {
        this.name = name;
        this.age = age;
        this.address = address; // JSON无address字段时，此处为null
    }

    // 按需添加getter方法（序列化或业务场景需要）
    public String getName() {
        return name;
    }

    public int getAge() {
        return age;
    }

    public String getAddress() {
        return address;
    }
}

2. 配合@JsonIgnoreProperties处理未知字段（可选） #

如果JSON中可能存在POJO未定义的其他字段，在类上添加@JsonIgnoreProperties(ignoreUnknown = true)，避免反序列化时因未知字段报错：

import com.fasterxml.jackson.annotation.JsonIgnoreProperties;

@JsonIgnoreProperties(ignoreUnknown = true)
public class StudentDetails {
    // ... 其余代码不变
}

3. 用Optional优雅处理可选字段（进阶） #

如果希望更规范地处理空值，可以将address改为Optional<String>，但需要引入jackson-datatype-jdk8依赖，让Jackson支持Optional类型的反序列化：

import java.util.Optional;

public class StudentDetails {

    @NotNull
    private final String name;

    @NotNull
    private final int age;

    private final Optional<String> address;

    @JsonCreator
    public StudentDetails(
            @JsonProperty("name") @NotNull String name,
            @JsonProperty("age") @NotNull int age,
            @JsonProperty("address") Optional<String> address) {
        this.name = name;
        this.age = age;
        this.address = address; // JSON无address字段时，此处为Optional.empty()
    }

    // getter方法
    public Optional<String> getAddress() {
        return address;
    }

    // 其余getter不变
}

为什么之前的注解没用？ #

• @NonNull/@Nullable：仅用于代码静态校验，不影响Jackson的反序列化逻辑；
• @JsonInclude：控制序列化时是否忽略null字段，和反序列化无关；
• @JsonIgnoreProperties：未设置ignoreUnknown = true或未配合构造方法时，无法解决可选字段缺失的问题；
• Optional<>：需要Jackson的JDK8模块支持，且必须配合构造方法的注解映射才能生效。

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