Hibernate中级联一对一删除时清理多对多关联的问题

在Hibernate项目中，尝试删除仍存在多对多关联记录的一对一关系实体时，触发外键约束错误。

实体类结构 #

@Getter
@Setter
@Entity
public class Employee implements Serializable {

    @Id
    Long id;

    @OneToOne(fetch = FetchType.LAZY, mappedBy = "employeeId", cascade = CascadeType.ALL, orphanRemoval = true)
    private AppUser appUser;
    
    // 其他基础字段

}

@Getter
@Setter
@Entity
public class AppUser implements Serializable {

    @Id
    Long id;

    @OneToOne
    @JoinColumn(name = "employeeId")
    @NotNull
    private Employee employeeId;

    @ManyToMany(fetch = FetchType.LAZY)
    @JoinTable(name = "AppUserPermission", joinColumns = @JoinColumn(name = "appUserId"), inverseJoinColumns = @JoinColumn(name = "permissionId"))
    private Set<Permission> permissions = new HashSet<>();
    
    // 其他基础字段
}

@Getter
@Setter
@Entity
public class Permission implements Serializable {

    @Id
    Long id;
    
    // 其他基础字段
}

数据库表结构 #

CREATE TABLE IF NOT EXISTS Employee
(
    id bigint NOT NULL,
    CONSTRAINT pk_Employee PRIMARY KEY (id)
);

CREATE TABLE IF NOT EXISTS AppUser
(
    id bigint NOT NULL,
    employeeId bigint NOT NULL,
    CONSTRAINT pk_AppUser PRIMARY KEY (id),
    CONSTRAINT uq_AppUser_employeeId UNIQUE (employeeId),
    CONSTRAINT fk_AppUser_employeeId FOREIGN KEY (employeeId)
        REFERENCES Employee (id) MATCH SIMPLE
        ON UPDATE RESTRICT
        ON DELETE RESTRICT
);

CREATE TABLE IF NOT EXISTS Permission
(
    id bigint NOT NULL,
    CONSTRAINT pk_Permission PRIMARY KEY (id)
);

CREATE TABLE IF NOT EXISTS AppUserPermission
(
    appUserId bigint NOT NULL,
    permissionId bigint NOT NULL,
    CONSTRAINT pk_AppUserPermission PRIMARY KEY (appUserId, permissionId),
    CONSTRAINT fk_AppUserPermission_appUserId FOREIGN KEY (appUserId)
        REFERENCES AppUser (id) MATCH SIMPLE
        ON UPDATE RESTRICT
        ON DELETE RESTRICT,
    CONSTRAINT fk_UserPermission_permissionId FOREIGN KEY (permissionId)
        REFERENCES Permission (id) MATCH SIMPLE
        ON UPDATE RESTRICT
        ON DELETE RESTRICT
);

测试场景 #

• 当AppUser无Permission关联时，执行employee.setAppUser(null);可正常删除AppUser；
• 先清理AppUser的Permissions再删除AppUser，操作可成功，但需要两次数据库更新；
• 直接执行删除操作时触发外键约束异常，JPA仅执行删除AppUser的SQL，期望先删除中间表关联记录再删除AppUser。

需求 #

• 无需修改数据库级联规则；
• 通过Hibernate一次操作完成删除；
• 仅清理中间表的关联记录，不删除Permission实体。

解决方案 #

方法一：使用@PreRemove注解自动清理关联 #

在AppUser实体中添加@PreRemove注解的方法，Hibernate会在删除AppUser实例前自动调用该方法，清空权限集合，从而自动删除中间表的关联记录，再执行AppUser的删除操作，一次事务完成所有步骤：

@Getter
@Setter
@Entity
public class AppUser implements Serializable {

    // 原有字段...

    @PreRemove
    private void preRemove() {
        permissions.clear();
    }
}

修改后，执行employee.setAppUser(null);时，Hibernate会按顺序执行：

1. 删除AppUserPermission中当前AppUser对应的所有关联记录；
2. 删除AppUser表中的对应记录。

注意事项 #

• 确保操作在同一个事务中执行，否则无法保证SQL执行顺序；
• 不要为@ManyToMany添加CascadeType.REMOVE级联，否则会导致关联的Permission实体被删除，不符合需求。

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