Spring Boot中ID相同但引用变更时实体更新的问题

一、你遇到的新增行为是否符合预期？ #

完全是预期内的，核心原因在于JPA对实体状态的管理逻辑：

从数据库查询出来的userEntity属于托管状态——它被当前的EntityManager追踪，修改后调用save()时，EntityManager明确知道这对应数据库里的已有行，因此会执行更新操作。

而通过toUserEntity()新建的实体是游离状态：哪怕ID和数据库里的行一致，它也不在EntityManager的托管范围内。此时save()的行为分两种情况：

1. 如果你的实体ID用了自增生成策略（比如@GeneratedValue(strategy = GenerationType.IDENTITY)），就算你手动设置了已有ID，数据库仍会自动生成新ID，最终插入新行——这是多数人踩这个坑的核心原因。
2. 如果ID不是自增策略，save()会执行merge()：先检查EntityManager里有没有同ID的托管实体，没有的话就从数据库加载对应实体，再把新对象的属性复制过去完成更新。但如果自增策略覆盖了你的手动ID，就会触发新增。

简单说：Spring Data JPA的save()不仅看ID是否为空，还要结合实体是否被托管、ID生成策略来决定是插入还是更新。

二、怎么让它仅通过ID判断更新/插入？ #

有几种可行的方案，可根据你的业务场景选择：

1. 调整ID生成策略 #

如果你的ID是业务主键（手动指定），不要用自增策略。比如改成@GeneratedValue(strategy = GenerationType.AUTO)，或者直接去掉@GeneratedValue，完全手动维护ID。这样当你给新实体设置已有ID时，JPA会认可这个ID，merge()会正确找到对应行执行更新。

2. 显式使用merge操作 #

直接调用EntityManager的merge()方法，强制根据ID查找并合并游离实体：

val userDto = userEntity.toUserDto()
userDto.name = "New Name"
val mergedEntity = entityManager.merge(userDto.toUserEntity())
userRepository.save(mergedEntity)

3. 自定义更新方法 #

在Repository里写自定义的更新SQL，直接通过ID定位行，完全绕开实体状态的问题：

interface UserRepository : JpaRepository<UserEntity, Long> {
    @Modifying
    @Query("UPDATE UserEntity u SET u.name = :name WHERE u.id = :id")
    fun updateNameById(@Param("id") id: Long, @Param("name") name: String)
}

这种方式最直接，性能也更高，适合只更新部分字段的场景。

4. 先判断ID是否存在再保存 #

保存前先检查ID对应的行是否存在，手动分支处理：

val userDto = userEntity.toUserDto()
userDto.name = "New Name"
val newEntity = userDto.toUserEntity()
newEntity.id?.let {
    if (userRepository.existsById(it)) {
        userRepository.save(newEntity)
    } else {
        userRepository.save(newEntity)
    }
}

注意：这种方式存在并发风险，比如检查后到保存前，数据可能被其他线程修改，需要配合事务保证原子性。

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