Jackson反序列化：非匹配响应时返回null对象的需求

方法一：优先判断HTTP状态码（推荐） #

既然你收到的是400这类明确的错误状态响应，直接先判断响应状态码，无需对错误响应做反序列化：

// 先检查响应状态码，4xx/5xx都是错误响应
if (response.statusCode() >= 400) {
    return null;
}
// 仅正常响应（2xx）才进行反序列化
POJO pojo = mapper.readValue(response.body().string(), POJO.class);
return pojo;

这个方法最直接高效，避免了对错误响应的无效反序列化操作。

方法二：反序列化后检查POJO属性 #

如果必须通过反序列化后判断（比如状态码不固定，但响应结构与POJO不匹配），可以编写工具方法检查POJO所有属性是否为空：

1. 编写属性检查工具方法 #

import java.lang.reflect.Field;

public class ObjectUtils {
    public static <T> T returnNullIfAllFieldsNull(T obj) throws IllegalAccessException {
        if (obj == null) {
            return null;
        }
        // 遍历所有字段，检查是否有非空值
        for (Field field : obj.getClass().getDeclaredFields()) {
            field.setAccessible(true);
            if (field.get(obj) != null) {
                return obj;
            }
        }
        // 所有属性都为空，返回null
        return null;
    }
}

2. 使用工具方法处理反序列化结果 #

POJO pojo = mapper.readValue(response.body().string(), POJO.class);
// 检查后返回null或原对象
pojo = ObjectUtils.returnNullIfAllFieldsNull(pojo);

方法三：自定义Jackson反序列化器 #

通过自定义反序列化逻辑，在反序列化完成后自动判断并返回null：

1. 实现自定义反序列化器 #

import com.fasterxml.jackson.core.JsonParser;
import com.fasterxml.jackson.databind.DeserializationContext;
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.deser.std.StdDeserializer;

import java.io.IOException;
import java.lang.reflect.Field;

public class NullIfEmptyDeserializer<T> extends StdDeserializer<T> {
    private final Class<T> targetClass;

    public NullIfEmptyDeserializer(Class<T> targetClass) {
        super(targetClass);
        this.targetClass = targetClass;
    }

    @Override
    public T deserialize(JsonParser parser, DeserializationContext context) throws IOException {
        JsonNode node = parser.getCodec().readTree(parser);
        // 反序列化为目标对象
        T obj = parser.getCodec().treeToValue(node, targetClass);
        
        // 检查所有属性是否为空
        try {
            for (Field field : targetClass.getDeclaredFields()) {
                field.setAccessible(true);
                if (field.get(obj) != null) {
                    return obj;
                }
            }
            return null;
        } catch (IllegalAccessException e) {
            throw new IOException("Failed to check object fields", e);
        }
    }
}

2. 注册反序列化器到ObjectMapper #

ObjectMapper mapper = new ObjectMapper();
mapper.findAndRegisterModules();
mapper.disable(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES);
// 其他原有配置...

// 为POJO类注册自定义反序列化器
mapper.registerModule(new com.fasterxml.jackson.databind.module.SimpleModule()
        .addDeserializer(POJO.class, new NullIfEmptyDeserializer<>(POJO.class)));

之后使用mapper.readValue()时，若反序列化得到的POJO所有属性均为null，会自动返回null。

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