Spring Boot场景下，如何基于字段名称判断Jackson注解Java类属性是否存在并获取属性值

嘿，针对你的场景，我来梳理下可行的实现方案。首先得明确核心需求：要根据JSON字段名（也就是@JsonProperty指定的名称）判断对象里是否对应字段“有效存在”，然后获取它的值——这里的“存在”我们分两种场景来处理，一种是判断字段有没有非空值，另一种是更严格的判断原始JSON里是否真的包含这个字段（哪怕值是null）。

方案一：基于反射+Jackson注解（无需修改实体类） #

这种方式适合不需要严格区分“字段不存在”和“字段存在但值为null”的场景，核心是通过反射找到对应@JsonProperty标记的字段，然后判断值是否符合预期。

完整实现代码 #

假设你在Spring Boot环境下，可以直接注入框架提供的ObjectMapper（非Spring环境自己new一个也可以）：

import com.fasterxml.jackson.annotation.JsonProperty;
import java.lang.reflect.Field;
import java.util.Optional;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;

@Component
public class MyFieldProcessor {

    // 注入Spring自动配置的ObjectMapper（预留扩展空间）
    private final ObjectMapper objectMapper;

    @Autowired
    public MyFieldProcessor(ObjectMapper objectMapper) {
        this.objectMapper = objectMapper;
    }

    void doSomething(MyClass obj) {
        for (String fieldName : new String[]{"foo", "bar"}) {
            try {
                if (objectContains(obj, fieldName)) {
                    Object value = getValueByName(obj, fieldName);
                    // 这里写你的业务逻辑，比如打印值或后续处理
                    System.out.printf("字段[%s]的值是：%s%n", fieldName, value);
                }
            } catch (IllegalAccessException e) {
                // 实际项目建议换成日志记录
                e.printStackTrace();
            }
        }
    }

    /**
     * 判断对象中是否存在指定JSON字段名的有效字段
     * 对于Optional类型，判断是否非空；普通类型判断是否非null
     */
    private boolean objectContains(MyClass obj, String fieldName) throws IllegalAccessException {
        // 遍历类的所有字段
        for (Field field : obj.getClass().getDeclaredFields()) {
            // 获取Jackson的JsonProperty注解，拿到JSON里的字段名
            JsonProperty jsonProp = field.getAnnotation(JsonProperty.class);
            String jsonFieldName = jsonProp != null ? jsonProp.value() : field.getName();
            
            if (jsonFieldName.equals(fieldName)) {
                field.setAccessible(true); // 允许访问私有字段
                Object fieldValue = field.get(obj);
                
                // 针对Optional类型做特殊判断
                if (fieldValue instanceof Optional) {
                    return !((Optional<?>) fieldValue).isEmpty();
                } else {
                    return fieldValue != null;
                }
            }
        }
        // 没找到对应字段返回false
        return false;
    }

    /**
     * 根据JSON字段名获取对象对应的属性值
     */
    private Object getValueByName(MyClass obj, String fieldName) throws IllegalAccessException {
        for (Field field : obj.getClass().getDeclaredFields()) {
            JsonProperty jsonProp = field.getAnnotation(JsonProperty.class);
            String jsonFieldName = jsonProp != null ? jsonProp.value() : field.getName();
            
            if (jsonFieldName.equals(fieldName)) {
                field.setAccessible(true);
                return field.get(obj);
            }
        }
        throw new IllegalArgumentException("找不到JSON字段名：" + fieldName);
    }

    // 你的原始MyClass类
    public static class MyClass {
        @JsonProperty
        String foo;
        @JsonProperty
        Optional<Integer> bar;
    }
}

方案说明 #

• 为什么用@JsonProperty匹配字段名？因为如果实体类字段和JSON字段名不一致（比如@JsonProperty("user_name") String userName），这种方式能准确对应到JSON里的字段名，而不是Java类的变量名。
• 针对Optional类型判断是否非空，普通类型判断是否非null——刚好对应“原始JSON里有这个字段且值有效”的场景。
• 反射时需要调用field.setAccessible(true)，因为实体类字段大概率是私有的。

方案二：严格区分“字段存在”和“字段不存在”（需要修改实体类） #

如果必须知道原始JSON里真的有这个字段（哪怕值是null），而不是字段只是有默认值，上面的方案就不够用了——因为Optional.empty()既可能是字段不存在，也可能是字段存在但值为null。这时候可以给实体类加标记位，用@JsonSetter跟踪字段是否被反序列化过。

修改后的实体类 #

public static class MyClass {
    @JsonProperty
    String foo;
    // 标记foo是否被JSON设置过
    private boolean fooWasSet = false;

    @JsonProperty
    Optional<Integer> bar;
    // 标记bar是否被JSON设置过
    private boolean barWasSet = false;

    // 用@JsonSetter标记set方法，每次被调用就说明JSON里有这个字段
    @JsonSetter
    public void setFoo(String foo) {
        this.foo = foo;
        this.fooWasSet = true;
    }

    @JsonSetter
    public void setBar(Optional<Integer> bar) {
        this.bar = bar;
        this.barWasSet = true;
    }

    // 提供获取标记的方法
    public boolean isFooWasSet() {
        return fooWasSet;
    }

    public boolean isBarWasSet() {
        return barWasSet;
    }
}

对应的objectContains方法 #

private boolean objectContains(MyClass obj, String fieldName) {
    return switch (fieldName) {
        case "foo" -> obj.isFooWasSet();
        case "bar" -> obj.isBarWasSet();
        default -> false;
    };
}

方案说明 #

• 核心是利用@JsonSetter：只有当JSON里存在对应字段时，Jackson才会调用对应的set方法，我们就在set方法里把标记位设为true。
• 优点是能100%准确判断原始JSON里是否有这个字段；缺点是需要修改实体类，每个字段都要加对应的标记位和set方法，适合字段不多的场景。

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