为何一个JPA实体修改标识符无报错，另一个却抛出异常？

问题背景 #

基于Spring Boot开发授权微服务，包含Permission、Role、User三个模块，每个模块对应@Entity类和JpaRepository。所有实体采用@IdClass定义复合ID，由字符串ID+createdAt时间戳组成——设计逻辑是修改实体时在数据库新增一行，且不能修改表结构。

最初修改ID的时间戳部分时抛出HibernateException，于是用@PrePersist自动更新时间戳：

@PrePersist
private void updateTimestamp() {
  createdAt = Instant.now();
}

该方案对Permission实体有效，但测试Role实体更新时，仍抛出以下异常：

org.hibernate.HibernateException: identifier of an instance of com.example.auth.model.Role was altered from RoleId(roleId=TEST_ROLE_R2, createdAt=2023-09-04T21:52:39.860899Z) to RoleId(roleId=TEST_ROLE_R2, createdAt=2023-08-31T23:12:25.927743Z)

更诡异的是，异常触发在调用权限仓库的permissionRepository.findMostRecentPermissionById(p)方法时，该方法定义如下，且在其他场景下正常：

@Query(
    value = "SELECT * FROM auth.permissions WHERE permissionID = :permissionID ORDER BY createdat DESC LIMIT 1",
    nativeQuery = true
)
Permission findMostRecentPermissionById(String permissionID);

目前尚未明确异常触发位置的原因，但通过entityManager.detach(entity)手动设置时间戳后可成功新增实体。

核心原因拆解 #

1. Hibernate的持久化实体ID约束：Hibernate绝不允许修改处于托管状态（在EntityManager持久化上下文中）的实体ID。如果Role实体在被修改createdAt（复合ID的一部分）时仍处于托管状态，直接触发ID篡改异常。
2. 异常触发位置的误导性：异常并非由Permission的查询方法导致，而是当前事务中已存在一个被修改了ID的Role实体。Hibernate在事务执行过程中（比如查询触发的上下文同步）会检查所有托管实体的状态，发现Role的ID被篡改，因此抛出异常——只是刚好在调用查询方法时触发了检查。
3. Permission与Role的行为差异：Permission实体更新时可能已被自动或手动从持久化上下文分离，而Role实体始终处于托管状态，修改ID自然触发异常。

可行解决方案 #

• 手动分离实体后修改：更新Role前调用entityManager.detach(role)将其从持久化上下文移除，此时修改复合ID的createdAt不会触发Hibernate的ID检查，之后调用save()插入新行（这也是你已经验证有效的方案）。
• 创建新实体代替修改原有实体：不要直接修改托管实体的ID，而是复制原有实体的属性，创建新实体并设置新的createdAt，再调用save()插入新行，完全契合"新增行"的设计逻辑：

// 示例代码
Role existingRole = roleRepository.findMostRecentRoleById(roleId);
Role newRole = new Role();
newRole.setRoleId(existingRole.getRoleId());
newRole.setCreatedAt(Instant.now());
// 复制其他业务属性
newRole.setPermissions(existingRole.getPermissions());
// ... 其他属性复制
roleRepository.save(newRole);

• 检查事务边界：确认Role修改与Permission查询是否在同一事务内。如果是同一事务，Hibernate会在事务提交或上下文同步时检查所有托管实体，导致异常提前暴露在查询时。可拆分事务，或在修改Role后立即flush并分离。
• 验证@PrePersist执行时机：@PrePersist仅在实体**首次持久化（插入）**时触发，若你是修改已有托管实体的ID，该方法不会执行。如果Role的更新逻辑是基于托管实体修改ID，@PrePersist根本不会生效，反而可能因为手动修改ID触发异常。

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