OneToOne关联中orphanRemoval失效，删除User触发外键约束错误

问题场景 #

实体类代码 #

@Entity
@Table(name = "user")
public class UserDb {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @OneToOne(mappedBy = "user", cascade = CascadeType.ALL, orphanRemoval = true)
    private BorrowerDb borrowerDb;
}

@Entity
@Table(name = "borrower")
public class BorrowerDb {
   @Id
   @GeneratedValue(strategy = GenerationType.IDENTITY)
   private Long id;

   @MapsId
   @OneToOne(fetch = FetchType.LAZY, optional = false, cascade = CascadeType.REMOVE)
   @JoinColumn(name = "id", nullable = false)
   private UserDb user;
}

执行操作报错 #

执行原生SQL语句 delete from user where id = ... 时，触发以下错误：

java.sql.SQLIntegrityConstraintViolationException: Cannot delete or update a parent row: a foreign key constraint fails (`test`.`borrower`, CONSTRAINT `FK_7x1elq6p8384hj65g38w08jsm` FOREIGN KEY (`id`) REFERENCES `user` (`id`))

需求：删除User的同时自动删除关联的Borrower实例。

原因 #

1. 原生SQL绕过JPA级联逻辑：JPA配置的cascade规则只在通过实体管理器操作实体时生效，直接执行原生SQL不会触发JPA的级联删除流程，数据库外键约束会阻止删除存在关联数据的父表记录。
2. 数据库外键无级联删除规则：Borrower表的外键约束没有配置ON DELETE CASCADE，数据库本身没有自动删除关联Borrower的逻辑，所以删User时会报错。
3. 实体类主键配置冲突：BorrowerDb同时使用@GeneratedValue和@MapsId，这两个注解冲突——@MapsId表示主键来自关联的User，不需要再自动生成主键，这个问题会导致主键逻辑混乱，也可能影响级联操作的正确性。

解决方案 #

方案一：通过JPA操作实体删除（推荐） #

改用JPA的实体管理器或Spring Data JPA的Repository方法删除User，这样会触发配置的级联删除：

// Spring Data JPA示例
userRepository.deleteById(userId);

执行时JPA会先删除关联的Borrower，再删除User，不会触发数据库外键约束错误。

方案二：修改数据库外键添加级联规则 #

如果必须用原生SQL删除，需要修改Borrower表的外键约束，添加ON DELETE CASCADE：

-- 先删除原有外键
ALTER TABLE borrower 
DROP FOREIGN KEY FK_7x1elq6p8384hj65g38w08jsm;

-- 添加带级联删除的外键
ALTER TABLE borrower 
ADD CONSTRAINT FK_7x1elq6p8384hj65g38w08jsm 
FOREIGN KEY (id) REFERENCES user(id) 
ON DELETE CASCADE;

注意替换实际的外键名称为你数据库中的对应名称。

方案三：修正实体类主键配置 #

删除BorrowerDb中的@GeneratedValue注解，因为@MapsId已经指定主键来自关联的User：

@Entity
@Table(name = "borrower")
public class BorrowerDb {
   @Id
   private Long id;

   @MapsId
   @OneToOne(fetch = FetchType.LAZY, optional = false, cascade = CascadeType.REMOVE)
   @JoinColumn(name = "id", nullable = false)
   private UserDb user;
}

这样既符合共享主键的一对一设计，也避免了主键生成逻辑的冲突。

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