Spring Boot+JPA+PostgreSQL中Post删除时SubPost级联删除及反序列化问题

执行Post的级联删除时，JPA默认会先加载关联的SubPost实体（级联操作需要基于实体对象执行）。如果SubPost的test_col字段被映射为LinkedHashMap（仅适配JSON对象结构），而数据库中存储的是JSON数组，Jackson在反序列化时会尝试将数组结构转换为键值对形式的Map，这就会触发类型不匹配错误——数组无法直接反序列化为LinkedHashMap，导致实体加载失败，级联删除流程中断。

即使你将字段类型改为LinkedHashMap，本质问题依然存在：映射类型只能兼容JSON对象，无法适配数组结构，因此反序列化错误会持续出现。

以下两种方案可解决该问题，可根据业务需求选择：

方案1：使用兼容JSON对象/数组的映射类型 #

将test_col的类型改为Jackson的JsonNode，它原生支持JSON对象、数组等所有JSON结构，能完美适配数据库中存储的不同JSON格式。

基于Hibernate Types库（适用于Spring Boot 2.x/Hibernate 5） #

1. 引入Hibernate Types依赖（Maven）：

<dependency>
    <groupId>com.vladmihalcea</groupId>
    <artifactId>hibernate-types-52</artifactId>
    <version>2.20.0</version>
</dependency>

2. 在SubPost实体中定义字段：

import com.fasterxml.jackson.databind.JsonNode;
import org.hibernate.annotations.Type;
import com.vladmihalcea.hibernate.type.json.JsonNodeType;
import jakarta.persistence.Column;
import jakarta.persistence.Entity;

@Entity
public class SubPost {
    // 其他字段...
    
    @Column(name = "test_col", columnDefinition = "jsonb")
    @Type(JsonNodeType.class)
    private JsonNode testCol;
    
    // Getter/Setter...
}

基于Hibernate 6原生支持（适用于Spring Boot 3.x） #

Spring Boot 3.x搭配Hibernate 6，无需额外依赖，直接使用原生JSON类型支持：

import com.fasterxml.jackson.databind.JsonNode;
import jakarta.persistence.Column;
import jakarta.persistence.Entity;
import jakarta.persistence.JdbcTypeCode;
import jakarta.persistence.SqlTypes;

@Entity
public class SubPost {
    // 其他字段...
    
    @Column(name = "test_col", columnDefinition = "jsonb")
    @JdbcTypeCode(SqlTypes.JSON)
    private JsonNode testCol;
    
    // Getter/Setter...
}

方案2：跳过实体加载，直接执行删除语句 #

如果业务上不需要在删除时加载SubPost实体，可以通过自定义JPQL查询直接删除关联数据，避免触发反序列化操作。

修改Post实体的关联注解，并添加自定义删除逻辑：

import jakarta.persistence.CascadeType;
import jakarta.persistence.Entity;
import jakarta.persistence.OneToMany;
import jakarta.persistence.PostRemove;
import jakarta.persistence.EntityManager;
import jakarta.persistence.PersistenceContext;
import java.util.List;

@Entity
public class Post {
    // 其他字段...
    
    @OneToMany(mappedBy = "post", cascade = CascadeType.REFRESH, fetch = FetchType.LAZY)
    private List<SubPost> subPosts;
    
    @PersistenceContext
    private EntityManager entityManager;
    
    @PostRemove
    private void deleteSubPosts() {
        entityManager.createQuery("DELETE FROM SubPost s WHERE s.post.id = :postId")
                     .setParameter("postId", this.getId())
                     .executeUpdate();
    }
    
    // Getter/Setter...
}

这里将级联策略改为CascadeType.REFRESH（避免默认加载实体），然后通过@PostRemove回调执行批量删除，直接操作数据库而不加载SubPost实体，自然不会触发test_col的反序列化。

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