Spring Data JPA：MySQL中OneToOne关联级联删除子记录失败

你的核心问题在于OneToOne关联的拥有方配置、外键约束方向与级联逻辑不匹配，导致JPA或数据库的级联删除未触发。以下是两种可行的解决方案，分别基于JPA级联和数据库级联实现需求：

方案一：保留现有外键位置（DM表存DM_DATA_ID），依赖JPA级联删除 #

此方案通过JPA的级联规则处理子实体删除，无需调整数据库外键方向，但需确保关联配置完全正确。

1. 修正实体关联配置 #

确保拥有方（DM）和反向方（DM_DATA）的映射完全匹配：

// DM实体（拥有方，持有外键）
@Entity
@Table(name = "DM")
public class DM {
    @Id
    @Column(name = "DM_ID") // 假设DM表主键为DM_ID
    private Long id;

    // 配置级联删除+孤儿删除，强制立即加载关联实体
    @OneToOne(cascade = CascadeType.REMOVE, orphanRemoval = true, fetch = FetchType.EAGER)
    @JoinColumn(
        name = "DM_DATA_ID",
        referencedColumnName = "DMD_DATA_ID",
        nullable = false
    )
    private DMData dmData;

    // getter、setter方法
}

// DM_DATA实体（反向方，无外键）
@Entity
@Table(name = "DM_DATA")
public class DMData {
    @Id
    @Column(name = "DMD_DATA_ID")
    private Long id;

    // mappedBy值必须严格对应DM类中关联DMData的字段名（此处为dmData）
    @OneToOne(mappedBy = "dmData")
    private DM dm;

    // getter、setter方法
}

2. 确保删除操作在事务中执行 #

JPA的级联操作必须在事务上下文内生效：

@Repository
public interface DMRepository extends JpaRepository<DM, Long> {
    // Spring Data JPA默认delete方法已包含事务，自定义方法需显式添加
    @Transactional
    void deleteById(Long id);
}

3. 数据库外键调整 #

原外键FK_DM_DATA_ID无需设置ON DELETE CASCADE（此配置的作用是删除DM_DATA时自动删除关联DM，与你的需求相反），建议保留默认的ON DELETE RESTRICT，防止出现孤立的DM记录。

方案二：调整外键到DM_DATA表，依赖数据库级联删除 #

此方案通过数据库外键的ON DELETE CASCADE实现级联删除，性能更高，且绕过JPA直接操作数据库时也能生效。

1. 调整数据库结构 #

执行SQL迁移脚本，将外键转移到DM_DATA表：

-- 给DM_DATA添加关联DM的外键列
ALTER TABLE DM_DATA ADD COLUMN DM_ID BIGINT;
-- 创建外键并设置ON DELETE CASCADE，删除DM时自动删除关联DM_DATA
ALTER TABLE DM_DATA ADD CONSTRAINT FK_DM_DATA_DM 
FOREIGN KEY (DM_ID) REFERENCES DM(DM_ID) ON DELETE CASCADE;
-- 删除DM表中原有的DM_DATA_ID列
ALTER TABLE DM DROP COLUMN DM_DATA_ID;

2. 修正JPA实体配置 #

此时DM_DATA成为关联拥有方（持有外键）：

// DM实体（反向方）
@Entity
@Table(name = "DM")
public class DM {
    @Id
    @Column(name = "DM_ID")
    private Long id;

    // mappedBy对应DM_DATA中关联DM的字段名（此处为dm）
    @OneToOne(mappedBy = "dm", cascade = CascadeType.REMOVE, orphanRemoval = true)
    private DMData dmData;

    // getter、setter方法
}

// DM_DATA实体（拥有方）
@Entity
@Table(name = "DM_DATA")
public class DMData {
    @Id
    @Column(name = "DMD_DATA_ID")
    private Long id;

    // unique=true保证OneToOne关联的唯一性
    @OneToOne
    @JoinColumn(
        name = "DM_ID",
        referencedColumnName = "DM_ID",
        unique = true,
        nullable = false
    )
    private DM dm;

    // getter、setter方法
}

常见问题排查 #

1. mappedBy值不匹配：反向关联的mappedBy必须与拥有方的关联字段名完全一致（大小写敏感），否则JPA无法识别关联关系；
2. 懒加载导致级联失效：若使用FetchType.LAZY，删除前需手动加载关联实体（如调用dm.getDmData()），否则JPA无法触发级联删除；
3. 事务缺失：删除操作必须在@Transactional注解修饰的方法中执行，否则JPA的级联逻辑不会生效；
4. 外键方向错误：外键在引用方时，ON DELETE CASCADE的作用是删除被引用方时删除引用方，与你的需求相反时不会生效。

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