jpa 默认使用 `@generatedvalue` 时会忽略你手动赋值的 id，导致数据库中保存的是新生成的 uuid。解决方法是移除 `@generatedvalue` 注解，并确保实体 id 在持久化前已明确赋值。
在使用 JPA（如 Hibernate）管理实体时，若希望对 @Id 字段（例如 UUID）实现“手动指定优先、仅当为空时才生成”的行为，关键在于正确配置主键生成策略——不能使用 @GeneratedValue。该注解的存在会强制 JPA 在 persist() 或 save() 时覆盖你已设置的 ID 值，无论其是否为 null。
✅ 正确做法：移除 @GeneratedValue，显式控制 ID
修改你的实体类如下：
@Data
@Builder
@Entity
@Table(name = "steps")
@NoArgsConstructor
@AllArgsConstructor
@EntityListeners(AuditingEntityListener.class)
public class Step implements Serializable {
@Id
private UUID id; // ← 完全移除 @GeneratedValue！
private String action;
private String type;
private String createdBy;
private String modifiedBy;
private String team;
// 其他字段...
}此时，JPA 将把 id 视为应用层完全自主管理的标识符：
- 若你调用 step.setId(someUuid)，则该值会被原样插入数据库；
- 若 id == null，且你执行 save()，则会抛出 IdentifierGenerationException（因为无生成策略），这反而是预期的安全行为——提醒你必须显式设值。
✅ 保存示例（安全可靠）
UUID customId = UUID.fromString("7f173364-1ad9-4e45-94ab-788fb641edb5");
Step step = Step.builder()
.id(customId) // ✅ 显式设置
.action("PROCESS_PAYMENT")
.type(StepType.STEP.name())
.createdBy("admin")
.modifiedBy("admin")
.team("finance")
.build();
stepRepository.save(step); // → 数据库中 id 精确等于 customId⚠️ 注意事项与最佳实践
- 不要混用策略：@GeneratedValue 与手动赋值逻辑互斥。一旦保留该注解，JPA 实现（如 Hibernate）会在 flush 阶段强制调用生成器，覆盖你的值。
- 考虑业务语义：UUID 手动指定适用于导入、迁移、幂等创建等场景；但需确保全局唯一性由业务层保障（例如通过分布式 ID 服务或严格校验）。
-
启用 @PrePersist 校验（可选增强）：
@PrePersist public void validateId() { if (id == null) { throw new IllegalStateException("ID must be set before persisting Step entity"); } } - Repository 层无需特殊处理：Spring Data JPA 的 save() 对于已有 @Id 值的实体会自动执行 INSERT（非 MERGE），前提是未启用 @Version 或乐观锁冲突。
✅ 总结
让 JPA 使用你指定的 UUID 主键，核心就是去掉 @GeneratedValue，将主键交由业务逻辑全权负责。这种方式简洁、可控、符合 JPA 规范，且避免了隐式行为带来的调试陷阱。只要确保 ID 分配逻辑健壮，它不仅是可行的，而且是推荐的显式设计模式。
