Spring Data JPA删除projectStatus父实体抛出H2约束违规异常

• 报错对应的物理外键，是Hibernate根据实体上的@JoinColumns关联自动在projectStatusHistory表上生成的：外键关联了projectStatus表的projectName + createDate联合主键，默认约束规则为「主表关联记录存在时，从表关联行不能被解绑，主表记录不能被直接删除」。
• 你在projectComplete方法中，刚把当前项目的最终状态存入projectStatusHistory表，这条新插入的历史记录的projectName、createDate值和你接下来要删除的projectStatus记录的联合主键完全匹配，数据库校验到从表仍存在和待删主表记录绑定的行，就直接抛出参照完整性违规。
• 现有实体映射和业务逻辑本身存在架构不匹配：业务设计里项目完成后，历史归档记录需要永久留存，主表仅保留活跃项目的当前状态，这种场景下主表和历史归档表不该建立强物理外键绑定——外键的设计目标是保证「从表关联的主表记录始终有效」，但归档后的历史记录本身就允许对应的主表活跃记录被清理。

按推荐优先级排序：

• 移除历史表对主表的强JPA关联
  • 直接删掉ProjectStatusHistory实体里的@ManyToOne关联字段：历史表本身已经冗余存储了projectName、createDate、status、更新时间等所有业务需要的字段，完全不需要通过JPA关联去导航查询主表的活跃状态。
  • 同步删掉ProjectStatus实体里的@OneToMany反向关联列表：既然历史表是独立归档存储，不需要双向维护关联关系，保留这个EAGER加载的关联反而会带来不必要的性能开销（每次查项目状态都会把全量历史一起拉出来）。
  • 实体映射移除后，Hibernate重新生成表结构时，就不会再创建那个指向projectStatus的物理外键，后续删除主表活跃记录时自然不会触发约束校验。
• 调整存量数据库的外键配置
  • 如果是已经上线的存量库，不需要改实体代码的情况下，直接在数据库层面执行DDL删掉那个和报错ID一致的物理外键约束即可。归档表和主表是完全独立的存储关系，保留外键只会和业务逻辑冲突。
• 修正业务代码中的潜在问题
  • 原ProjectStatus实体中history字段的类型写为小写开头的projectStatusHistory，属于类名定义错误，需要修正为标准类名ProjectStatusHistory，否则无法正常编译。
  • 原projectStatusChanged方法里，projectStatus.History = projectStatusHistory写法存在类型错误：history字段是List<ProjectStatusHistory>类型，不能直接赋值单个历史对象，需要通过projectStatus.getHistory().add(projectStatusHistory)的方式追加关联记录。
  • 原projectStatusChanged方法的逻辑顺序也需要调整：应该先把旧状态存入历史表，再修改主表的状态值，避免历史记录存的是已经修改后的新状态。

public void projectComplete(ProjectStatusId projectStatusId){
    ProjectStatus projectStatus = projectStatusRepository.findById(projectStatusId)
        .orElseThrow(() -> new IllegalArgumentException("项目状态不存在"));
    // 从当前项目状态构建最终归档历史记录
    ProjectStatusHistory finalHistory = buildHistoryFromStatus(projectStatus);
    // 独立存入历史归档表（无外键绑定）
    projectStatusHistoryRepository.save(finalHistory);
    // 直接删除主表的活跃记录
    projectStatusRepository.delete(projectStatus);
}

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