Kotlin Spring Boot使用@MapsId映射OneToOne时报detached entity错误如何解决？

报错核心原因 #

1. @MapsId实体配置错误 #

当使用@MapsId实现共享主键的一对一关联时，子实体（Ruleset）的主键值完全来自父实体（Target）的主键，不需要自己配置主键生成策略。你给Ruleset的id字段同时加了@Id @GeneratedValue，和@MapsId的主键复用逻辑冲突，会打乱Hibernate的实体状态判断逻辑。

2. @PostConstruct上的@Transactional不生效 #

@PostConstruct是Bean初始化阶段的回调，执行时Spring的事务切面代理还未完全初始化，你标注的@Transactional不会生效。这就导致每一次Repository调用都独立运行在单独的事务中：

• 调用targetRepository.save完成后，事务直接提交，Target实体脱离持久化上下文变为游离态
• 后续调用rulesetRepository.save时，Ruleset关联的Target是游离态，且该关联没有配置级联持久化规则，Hibernate无法处理游离状态的关联实体，就抛出了detached entity passed to persist报错。

你改用常规@OneToOne后能正常运行的原因也很简单：这种映射下Ruleset有独立的主键生成逻辑，关联的Target只需要提供主键值作为外键即可，不需要处于持久化状态，所以不会触发游离实体的报错。

修复方案 #

第一步：修正Ruleset实体配置 #

去掉id字段上的@GeneratedValue注解，主键值由@MapsId自动从关联的Target中获取：

@Entity
class Ruleset(
    @OneToOne(fetch = FetchType.LAZY) @MapsId
    var target: Target,
    @Id 
    var id: Long? = null,
    // ... 其他属性
)

第二步：修复事务生效问题 #

不要把初始化逻辑放在@PostConstruct中，改用ApplicationReadyEvent事件监听，此时Spring上下文完全初始化完成，@Transactional注解可以正常生效，整个初始化逻辑运行在同一个事务内，Target实体不会提前游离：

@Component
class DataInitService(
    private val targetRepository: TargetRepository,
    private val rulesetRepository: RulesetRepository
) {
    @Transactional
    @EventListener(ApplicationReadyEvent::class)
    fun initData() {
        val target = Target()
        val persistedTarget = targetRepository.save(target)
        val rule = Ruleset(persistedTarget)
        rulesetRepository.save(rule)
    }
}

如果必须使用@PostConstruct实现初始化，可以改用TransactionTemplate手动声明事务边界，确保所有操作在同一个事务中执行即可。

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