Java Spring JPA保存一对一关联实体报错：detached entity passed to persist

问题原因 #

你遇到的org.hibernate.PersistentObjectException: detached entity passed to persist错误，核心原因是：

• Setting实体的@OneToOne关联配置了CascadeType.ALL，当执行settingRepo.save()时，Hibernate会尝试对关联的User执行persist操作。
• 但此时User已经通过endUserRepo.save()完成持久化，若不在同一个事务中，User会脱离当前持久化上下文，进入游离（detached）状态——即已有数据库主键，但Hibernate不再跟踪它。而persist方法仅支持处理未持久化的新实体，因此抛出错误。

解决方案 #

方案1：调整级联类型 #

既然你已经手动保存了User，无需让Setting再触发User的持久化操作。修改Setting的级联配置，去掉PERSIST（ALL包含了PERSIST），保留业务需要的级联类型：

@Entity
public class Setting {
    // 其他代码
    @OneToOne(cascade = CascadeType.MERGE) // 或根据需求选CascadeType.REMOVE等
    @JoinColumn(name = "user_id", referencedColumnName = "id")
    @NonNull
    private User user;
}

方案2：在同一事务中执行保存操作 #

如果要保留CascadeType.ALL，将两个保存操作放在同一个事务内，这样User保存后仍处于持久化上下文，不会变成游离状态。在业务方法上添加@Transactional注解：

@Transactional
public void createUserWithSetting() {
    var enduser = endUserRepo.save(new User("User1"));
    settingRepo.save(new Setting(enduser));
}

方案3：利用级联自动保存关联实体 #

无需手动分步保存，直接创建关联后的Setting，利用CascadeType.ALL自动触发User的持久化：

// 直接创建关联，保存Setting时自动保存User
var setting = new Setting(new User("User1"));
settingRepo.save(setting);

补充说明 #

• 游离实体：事务提交后，通过Repo保存的实体会脱离Hibernate持久化上下文，此时实体虽有主键，但Hibernate不再管理其状态变化。
• 关联拥有方：Setting是一对一关联的拥有方（带有@JoinColumn），数据库外键user_id在setting表中，操作关联关系时应以拥有方的配置为准。

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