Spring Boot JPA多对多映射中软删除失效的解决方案咨询

问题根源 #

JPA的@ManyToMany注解在更新关联关系时，会直接生成针对中间表的原生DELETE/INSERT语句，完全绕过你定义的EntityB实体，因此EntityB上的@SQLDelete软删除注解不会被触发。

方案一：替换@ManyToMany为双向一对多（推荐通用） #

将原有的多对多关联拆分为两个双向的一对多关联，让JPA通过EntityB实体操作关联关系，自然触发@SQLDelete的软删除逻辑。

修改EntityA #

class EntityA {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    // 替换原@ManyToMany关联
    @OneToMany(mappedBy = "entityAId", cascade = CascadeType.ALL, orphanRemoval = true)
    @JsonView(Views.ALL.class)
    @JsonIgnore
    private List<EntityB> mappings;
}

修改EntityC（可选，支持双向查询） #

class EntityC {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @OneToMany(mappedBy = "entityCId", cascade = CascadeType.ALL, orphanRemoval = true)
    private List<EntityB> mappings;
}

效果：当你更新EntityA的mappings集合时，移除元素会触发EntityB的@SQLDelete执行软删除，添加元素则正常插入，完全符合预期逻辑，且所有多对多关联都可以按此方式统一改造，维护成本低。

方案二：全局拦截DELETE语句（无需修改实体关联） #

通过Hibernate拦截器，全局捕获针对中间表的DELETE语句，替换为软删除的UPDATE语句，适合不想改动现有实体关联结构的场景。

自定义拦截器 #

public class SoftDeleteJoinTableInterceptor extends EmptyInterceptor {
    @Override
    public String onPrepareStatement(String sql) {
        // 拦截entity_b表的DELETE，替换为软删除UPDATE
        if (sql.startsWith("DELETE FROM entity_b")) {
            String whereClause = sql.substring(sql.indexOf("WHERE"));
            return "UPDATE entity_b SET is_deleted = 1 " + whereClause;
        }
        // 可扩展添加其他中间表的拦截规则
        if (sql.startsWith("DELETE FROM other_join_table")) {
            String whereClause = sql.substring(sql.indexOf("WHERE"));
            return "UPDATE other_join_table SET is_deleted = 1 " + whereClause;
        }
        return super.onPrepareStatement(sql);
    }
}

配置拦截器到Spring Boot #

@Configuration
public class HibernateConfig {
    @Bean
    public LocalContainerEntityManagerFactoryBean entityManagerFactory(DataSource dataSource) {
        LocalContainerEntityManagerFactoryBean em = new LocalContainerEntityManagerFactoryBean();
        em.setDataSource(dataSource);
        em.setPackagesToScan("com.your.package.entity"); // 替换为你的实体包路径
        HibernateJpaVendorAdapter vendorAdapter = new HibernateJpaVendorAdapter();
        em.setJpaVendorAdapter(vendorAdapter);
        
        Map<String, Object> jpaProperties = new HashMap<>();
        jpaProperties.put("hibernate.ejb.interceptor", SoftDeleteJoinTableInterceptor.class);
        em.setJpaPropertyMap(jpaProperties);
        
        return em;
    }
}

效果：所有针对中间表的原生DELETE操作都会被自动替换为软删除的UPDATE，无需修改任何业务代码，适合快速适配现有多组多对多关联。

方案三：单实体自定义关联操作（特定场景） #

针对单个实体，在Repository中自定义软删除和新增关联的方法，手动控制SQL执行逻辑。

自定义Repository方法 #

public interface EntityARepository extends JpaRepository<EntityA, Long> {
    @Modifying
    @Query("UPDATE EntityB b SET b.isDeleted = true WHERE b.entityAId = :entityAId AND b.entityCId IN (:entityCIds)")
    void softDeleteMappings(@Param("entityAId") Long entityAId, @Param("entityCIds") List<Long> entityCIds);

    @Modifying
    @Query("INSERT INTO EntityB(entityAId, entityCId) VALUES (:entityAId, :entityCId)")
    void addMapping(@Param("entityAId") Long entityAId, @Param("entityCId") Long entityCId);
}

使用方式：更新EntityA关联时，先调用softDeleteMappings标记旧关联为已删除，再调用addMapping添加新关联，避免JPA自动执行DELETE。

方案选择建议 #

• 优先选方案一：完全符合JPA规范，实体结构清晰，软删除逻辑统一维护在中间表实体中，后续扩展和维护成本最低。
• 若无法修改实体结构，选方案二：全局拦截无侵入，适配所有现有多对多关联。
• 仅针对个别实体的特殊需求，选方案三：灵活但需要重复编写自定义方法。

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