You need to enable JavaScript to run this app. Jackson 2.9.5反序列化如何忽略空JSON对象 避免生成空POJO及JPA脏数据?
优惠活动
大模型
产品
解决方案
定价
更多

Jackson 2.9.5反序列化如何忽略空JSON对象 避免生成空POJO及JPA脏数据?

故障根因定位

你之前写的反序列化包装器触发异常的核心原因是方法执行顺序完全颠倒:

  • 先调用标准反序列化器deserializer.deserialize(p, ctxt)把JsonParser的流内容全部读取解析成Java对象,此时JsonParser的游标已经移动到当前JSON对象的末尾
  • 之后再尝试调用codec.readTree(p)读取当前节点,解析器已经没有剩余可读内容,自然就会抛出MismatchedInputException: No _valueDeserializer assigned的错误。
全局空对象识别的正确实现

不需要为每个JPA实体单独写反序列化器,只要修正包装逻辑的执行顺序,配合BeanDeserializerModifier即可实现对所有实体类的统一处理,完全适配Jackson 2.9.5的版本API。

核心逻辑调整点:

  1. 进入deserialize方法后,必须先读取当前JSON节点为JsonNode,再执行后续的标准反序列化流程。Jackson的readTree方法会自动在读取完成后把JsonParser的游标重置到节点起始位置,不会影响后续标准反序列化器的正常工作
  2. 对读取到的JsonNode做空值判断:如果是空的Object节点(对应JSON里的{}结构),直接返回null,跳过后续反序列化流程,从根源上避免空对象被实例化
  3. 仅对带@Entity注解的JPA实体类应用包装逻辑,基础类型、非实体类仍然走标准反序列化流程,避免影响其他业务逻辑

修正后的自定义包装器代码:

public class EmptyObjectSkippingDeserializer extends JsonDeserializer<Object> {
    private final JsonDeserializer<?> defaultDeserializer;
    private final Class<?> targetClass;

    public EmptyObjectSkippingDeserializer(JsonDeserializer<?> defaultDeserializer, Class<?> targetClass) {
        this.defaultDeserializer = defaultDeserializer;
        this.targetClass = targetClass;
    }

    @Override
    public Object deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
        // 第一步:先读取当前JSON节点,此时游标会自动重置,不影响后续解析
        JsonNode currentNode = p.getCodec().readTree(p);
        
        // 判断是否为空对象结构
        if (currentNode.isObject()) {
            ObjectNode objectNode = (ObjectNode) currentNode;
            // 完全空的JSON对象(即前端传的{}),直接返回null
            if (objectNode.size() == 0) {
                return null;
            }
            // 可选扩展:如果节点仅包含id、version这类框架字段,无任何业务属性,也返回null
            boolean hasBusinessField = objectNode.fields().stream()
                .anyMatch(entry -> !"id".equals(entry.getKey()) && !"version".equals(entry.getKey()));
            if (!hasBusinessField) {
                return null;
            }
        }

        // 非空对象,走原有标准反序列化逻辑
        return defaultDeserializer.deserialize(p, ctxt);
    }

    @Override
    public boolean isCachable() {
        return defaultDeserializer.isCachable();
    }
}

对应的Jackson配置模块代码:

SimpleModule emptyObjectModule = new SimpleModule();
emptyObjectModule.setDeserializerModifier(new BeanDeserializerModifier() {
    @Override
    public JsonDeserializer<?> modifyDeserializer(DeserializationConfig config,
                                                  BeanDescription beanDesc,
                                                  JsonDeserializer<?> defaultDeserializer) {
        // 仅对JPA实体类应用空对象跳过逻辑
        boolean isJpaEntity = beanDesc.getAnnotation(Entity.class) != null;
        if (isJpaEntity) {
            return new EmptyObjectSkippingDeserializer(defaultDeserializer, beanDesc.getBeanClass());
        }
        return defaultDeserializer;
    }
});
// 将该模块注册到Spring容器管理的ObjectMapper实例中即可生效

当反序列化阶段把空的{}转换为null后,JPA在做级联保存时,关联字段为null自然不会触发CascadeType.ALL的级联插入逻辑,也就不会在数据库中生成只有id、version的空表记录。

实体层兜底逻辑(可选)

为了避免前端传入的对象不是完全空的{}、但所有业务字段都为null的情况(比如只有{"car": {"name": ""}}这类无效结构),可以抽一个所有JPA实体都继承的基类,加个持久化前置回调:

@MappedSuperclass
public abstract class BaseEntity {
    @Id
    @GeneratedValue
    private Long id;
    @Version
    private Long version;

    @PrePersist
    public void prePersist() {
        // 通过反射遍历字段,判断当前实体除id、version外的所有业务字段是否全空,为空就抛出校验异常阻止入库
        // 通用反射逻辑只需写一次,所有继承该基类的实体自动生效
    }
}
注意事项
  • 对集合类型的空对象(比如前端传的[])不需要做额外处理,空集合本身不会触发级联插入
  • 如果存在合法的空关联对象创建场景(比如用户主动新建一个空的Car关联),可以在空对象判断逻辑里加白名单,对带特殊标记字段的节点跳过判断
  • 不要对非JPA实体类应用这个包装逻辑,避免影响DTO、通用POJO的反序列化流程

内容的提问来源于stack exchange,提问作者Jochen Buchholz

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.15 07:54:00