Jackson反序列化：如何将'Unspecified'这类特定字符串视为null？

针对你遇到的API返回"Unspecified"无法反序列化为LocalDate的问题，无需预处理响应，Jackson提供了两种简便的解决方式：

1. 自定义LocalDate反序列化器+Mixin类（推荐） #

因为OpenAPI Generator生成的实体类直接修改后会被重新生成覆盖，用Mixin类可以在不改动生成代码的前提下注入自定义反序列化逻辑：

步骤1：编写自定义反序列化器 #

创建专门处理"Unspecified"的LocalDate反序列化器：

import com.fasterxml.jackson.core.JsonParser;
import com.fasterxml.jackson.databind.DeserializationContext;
import com.fasterxml.jackson.databind.deser.std.StdDeserializer;
import java.io.IOException;
import java.time.LocalDate;
import java.time.format.DateTimeFormatter;

public class UnspecifiedLocalDateDeserializer extends StdDeserializer<LocalDate> {
    private static final String UNSPECIFIED_VALUE = "Unspecified";
    private static final DateTimeFormatter DATE_FORMATTER = DateTimeFormatter.ISO_LOCAL_DATE;

    protected UnspecifiedLocalDateDeserializer() {
        super(LocalDate.class);
    }

    @Override
    public LocalDate deserialize(JsonParser parser, DeserializationContext context) throws IOException {
        String dateStr = parser.getText();
        if (UNSPECIFIED_VALUE.equals(dateStr)) {
            return null;
        }
        return LocalDate.parse(dateStr, DATE_FORMATTER);
    }
}

步骤2：创建Mixin类 #

Mixin类用于给生成的实体类字段绑定自定义反序列化器：

import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
import java.time.LocalDate;

public interface YourEntityMixin {
    @JsonDeserialize(using = UnspecifiedLocalDateDeserializer.class)
    LocalDate getMaturity();
}

注意替换YourEntityMixin为你实际生成的实体类对应的Mixin名称，getMaturity要和实体类的字段getter方法完全一致。

步骤3：注册Mixin到ObjectMapper #

在构建Jackson的ObjectMapper时注册Mixin，如果是OpenAPI生成的客户端，通常可以通过配置客户端的ObjectMapper实例完成：

import com.fasterxml.jackson.databind.ObjectMapper;

ObjectMapper objectMapper = new ObjectMapper();
objectMapper.addMixIn(YourGeneratedEntity.class, YourEntityMixin.class);

// 若为Spring环境，可通过Jackson2ObjectMapperBuilder配置
// Jackson2ObjectMapperBuilder builder = new Jackson2ObjectMapperBuilder();
// builder.mixIn(YourGeneratedEntity.class, YourEntityMixin.class);

2. 利用DateTimeFormatterBuilder构建支持特殊值的解析器 #

另一种方式是创建能识别"Unspecified"的DateTimeFormatter，配合@JsonFormat注解使用：

import java.time.format.DateTimeFormatter;
import java.time.format.DateTimeFormatterBuilder;

public class CustomDateFormatter {
    public static final DateTimeFormatter MATURITY_DATE_FORMATTER = new DateTimeFormatterBuilder()
            .appendOptional(DateTimeFormatter.ISO_LOCAL_DATE)
            .parseCaseInsensitive()
            .appendLiteral("Unspecified")
            .toFormatter();
}

再通过Mixin类绑定到字段：

import com.fasterxml.jackson.annotation.JsonFormat;
import java.time.LocalDate;

public interface YourEntityMixin {
    @JsonFormat(pattern = "yyyy-MM-dd", shape = JsonFormat.Shape.STRING)
    LocalDate getMaturity();
}

这种方式需确保解析器能正确识别两种格式，相对自定义反序列化器逻辑稍复杂。

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