使用Jackson处理Optional字段：缺失时生成Optional.empty()而非null

你遇到的问题核心在于：当JSON缺失Optional类型的字段时，Jackson使用无参构造器创建对象时会把final类型的Optional字段初始化为null，而Jdk8Module的Optional处理逻辑没有覆盖这个场景。以下是几种可行的解决方法：

方法一：修正构造器配置，处理null参数 #

移除@NoArgsConstructor(force = true)（它会让Jackson优先使用无参构造器，导致final字段初始化为null且无法修改），给全参构造器添加@JsonCreator和@JsonProperty注解，同时在构造器中把null转为Optional.empty()：

@EqualsAndHashCode
@ToString
@Getter
@Builder
public class Person1 {
    public final String name;
    public final Optional<Integer> age;

    @JsonCreator
    public Person1(@JsonProperty("name") String name, @JsonProperty("age") Optional<Integer> age) {
        this.name = name;
        this.age = age != null ? age : Optional.empty();
    }
}

这样Jackson反序列化时会调用这个构造器，当JSON缺失age字段时，会给构造器的age参数传入null，构造器自动将其转为Optional.empty()。

方法二：用@Builder.Default设置字段默认值 #

如果你依赖Lombok的@Builder，可以给age字段添加@Builder.Default注解，指定默认值为Optional.empty()：

@EqualsAndHashCode
@ToString
@Getter
@Builder
@AllArgsConstructor
@NoArgsConstructor // 若业务需要无参构造器可保留
public class Person1 {
    public final String name;
    @Builder.Default
    public final Optional<Integer> age = Optional.empty();
}

当JSON中缺失age字段时，Builder会自动使用默认的Optional.empty()初始化该字段。

方法三：配合ObjectMapper特性处理null值（补充） #

如果同时需要处理字段存在但值为null的情况，可以开启Jackson的ACCEPT_NULL_AS_EMPTY_CONTAINER特性，它会把null的容器类型（包括Optional）转为空容器：

ObjectMapper mapper = new ObjectMapper();
mapper.registerModule(new Jdk8Module());
mapper.enable(DeserializationFeature.ACCEPT_NULL_AS_EMPTY_CONTAINER);

为什么自定义反序列化器没生效？ #

因为当字段缺失时，Jackson不会触发该字段的反序列化器，反序列化器仅在字段存在（哪怕值是null）时才会被调用。所以要处理字段缺失的场景，必须从对象创建的环节（构造器、Builder）入手，而不是字段级的反序列化器。

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