Spring Boot复合主键实体修改保存报错：实体标识符被篡改

错误原因 #

JPA规范明确规定：实体的主键（包括复合主键的任意字段）是实体的唯一标识，一旦实体进入持久化状态（即被EntityManager管理），不允许修改主键字段。Hibernate作为JPA实现，检测到你修改了主键字段后，会认为你试图将当前实体转换为另一个完全不同的实体，因此抛出该错误。

另外注意你的错误信息里，主键的num字段从1234567变成了1356789，但你描述的是修改date字段，建议先检查代码是否不小心修改了num，或者复合主键类的equals/hashCode方法是否实现错误（必须基于所有主键字段生成）。

解决方案 #

方案1：删除原实体，创建新实体保存

既然不能修改主键，最直接的方式是删除旧的实体，再创建一个包含新date字段的新实体存入数据库：

// 1. 构建原实体的主键，查询旧实体
EntityPk oldPk = new EntityPk(1234567, oldDate, "12");
YourEntity oldEntity = entityManager.find(YourEntity.class, oldPk);

// 2. 删除旧实体
entityManager.remove(oldEntity);

// 3. 构建新主键和新实体，复制旧实体的非主键字段
EntityPk newPk = new EntityPk(1234567, newDate, "12");
YourEntity newEntity = new YourEntity();
newEntity.setId(newPk);
newEntity.setOtherField(oldEntity.getOtherField()); // 复制其他业务字段
// ... 其他字段赋值

// 4. 保存新实体
entityManager.persist(newEntity);

方案2：调整实体结构，将date从主键中移除

如果业务场景需要频繁修改date字段，建议重新设计实体：新增一个独立的自增主键，将num、date、typ设为普通字段，并通过唯一约束保证这三个字段的组合唯一性。这样修改date就不会触发主键变更的问题：

@Entity
@Table(name = "your_table_name", uniqueConstraints = {
    @UniqueConstraint(columnNames = {"num", "date", "typ"})
})
public class YourEntity {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id; // 新增自增主键

    private Long num;
    private Date date;
    private String typ;

    // 其他业务字段、getter/setter
}

额外检查：复合主键类的equals/hashCode实现

确保你的复合主键类（EntityPk）正确实现了equals和hashCode方法，必须基于所有主键字段（num、date、typ）来编写，否则Hibernate会无法正确识别实体的主键：

@Embeddable
public class EntityPk implements Serializable {
    private Long num;
    private Date date;
    private String typ;

    // 构造方法、getter/setter

    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        EntityPk entityPk = (EntityPk) o;
        return Objects.equals(num, entityPk.num) &&
               Objects.equals(date, entityPk.date) &&
               Objects.equals(typ, entityPk.typ);
    }

    @Override
    public int hashCode() {
        return Objects.hash(num, date, typ);
    }
}

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