JSON转POJO时如何区分字段显式赋值null和未传默认为null的场景

方案1：使用Jackson官方JsonNullable类型（推荐） #

该类型是Jackson专门为区分「字段未传递」和「字段显式传null」场景提供的能力，实现成本低、侵入性小。

实现步骤 #

1. 引入依赖（Spring Boot 2.6+已内置支持，低版本Spring Boot或非Spring Boot项目需手动引入）

<dependency>
    <groupId>org.openapitools</groupId>
    <artifactId>jackson-databind-nullable</artifactId>
    <version>0.2.6</version>
</dependency>

2. 修改实体类字段类型，默认值设为JsonNullable.undefined()

@Data
public class MyRequest implements Serializable {
    private JsonNullable<Integer> fieldA = JsonNullable.undefined();
    private JsonNullable<Integer> fieldB = JsonNullable.undefined();
}

3. 业务逻辑判断

// 判断fieldA是否被传入（无论值是否为null）
if (request.getFieldA().isPresent()) {
    // 显式传入fieldA，取值用 request.getFieldA().get()
} else {
    // 未传递fieldA字段
}

低版本Spring Boot需手动注册序列化模块：

@Bean
public Module jsonNullableModule() {
    return new JsonNullableModule();
}

方案2：手动维护字段赋值标记（无额外依赖） #

不需要引入第三方包，通过@JsonSetter在字段赋值时记录已传递的字段：

@Data
public class MyRequest implements Serializable {
    private Integer fieldA;
    private Integer fieldB;

    // 存储所有已传递的字段名
    private final Set<String> populatedFields = new HashSet<>();

    @JsonSetter
    public void setFieldA(Integer fieldA) {
        this.fieldA = fieldA;
        populatedFields.add("fieldA");
    }

    @JsonSetter
    public void setFieldB(Integer fieldB) {
        this.fieldB = fieldB;
        populatedFields.add("fieldB");
    }

    // 对外提供判断方法
    public boolean hasField(String fieldName) {
        return populatedFields.contains(fieldName);
    }
}

业务逻辑直接调用判断即可：

if (request.hasField("fieldA")) {
    // 显式传入fieldA
}

方案3：直接用JsonNode接收请求（适合临时场景） #

如果不想修改实体类，可以直接用Jackson的JsonNode接收原始请求，自行判断字段是否存在：

@PostMapping
@Produces({MediaType.APPLICATION_JSON})
@Consumes(value = {MediaType.APPLICATION_JSON})
public ResponseEntity<MyResponse> process(@RequestBody JsonNode requestNode)
        throws URISyntaxException {
    // 判断字段是否存在
    boolean hasFieldA = requestNode.has("fieldA");
    boolean hasFieldB = requestNode.has("fieldB");
    
    // 按需转换成实体类
    MyRequest request = new ObjectMapper().treeToValue(requestNode, MyRequest.class);
    Integer a = request.getFieldA();
    Integer b = request.getFieldB();
    ...
}

注意事项 #

不推荐使用Java自带的Optional类型实现该需求：Jackson默认会将显式传入的null反序列化为Optional.empty()，和未传递字段的反序列化结果一致，无法区分，需要额外修改全局配置，实现成本高于上述方案。

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