Spring Boot如何区分@RequestBody字段显式传null与未传入的情况

默认Jackson反序列化逻辑中，JSON中不存在的字段不会触发对应setter方法，只有字段明确传值（包括传null）才会调用setter，我们可以利用这个特性实现两类场景的区分，常用方案有3种：

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

这是和@RequestParam用Optional最接近的实现方式，适配性最好：

1. 高版本Spring Boot项目无需额外引入依赖，低版本可自行引入jackson-databind对应组件
2. 请求体字段用JsonNullable<T>包装，默认值设为未定义状态

import com.fasterxml.jackson.databind.util.JsonNullable;
import lombok.Data;

@Data
public class UserPatchRequestBody {
    // 初始状态为未定义，对应客户端未传字段的场景
    private JsonNullable<String> name = JsonNullable.undefined();
}

3. 业务侧直接调用方法判断状态即可：

if (requestBody.getName().isPresent()) {
    // isPresent()返回true说明客户端主动传了该字段，哪怕传的值是null
    String updateName = requestBody.getName().get();
    // 执行更新逻辑，值为null也正常更新
}
// 返回false说明客户端没传该字段，跳过对应字段的更新

方案2：自定义标记位实现（无额外依赖） #

如果不想引入额外类型，可以手动加标记位记录字段是否被赋值：

public class UserPatchRequestBody {
    private String name;
    // 标记name字段是否被客户端传递
    private boolean nameSet;

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
        // 只要触发setter就说明客户端传了该字段，标记设为true
        this.nameSet = true;
    }

    public boolean isNameSet() {
        return nameSet;
    }
}

业务侧直接判断isNameSet()的返回值即可完成区分。

方案3：全局捕获传参字段（适合多字段场景） #

如果请求体字段很多，不想每个字段单独加标记，可以用@JsonAnySetter统一捕获所有客户端传递的字段：

import com.fasterxml.jackson.annotation.JsonAnySetter;
import java.util.HashMap;
import java.util.Map;

public class UserPatchRequestBody {
    private String name;
    private Integer age;
    private String email;
    // 存储所有客户端传递的字段键值对
    private Map<String, Object> passedFields = new HashMap<>();

    @JsonAnySetter
    public void setPassedField(String key, Object value) {
        passedFields.put(key, value);
        // 可自行扩展反射逻辑批量给对应字段赋值，以下为简单示例
        switch (key) {
            case "name": this.name = (String) value; break;
            case "age": this.age = (Integer) value; break;
            case "email": this.email = (String) value; break;
        }
    }

    // 统一的字段存在判断方法
    public boolean isFieldPassed(String fieldName) {
        return passedFields.containsKey(fieldName);
    }

    // 省略其余getter
}

业务侧调用isFieldPassed("name")就能快速判断字段是否被传递。

注意事项 #

不要直接用java.util.Optional包装请求体字段：默认反序列化逻辑中，客户端传null会被反序列化为Optional.empty()，和未传字段的默认值完全一致，无法区分两种场景。

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