本文详解 Hibernate 6 中弃用 @GenericGenerator + UuidGenerator.class 组合后，如何通过标准注解 @UuidGenerator 正确配置 UUID 主键，避免类型不匹配错误，并支持 RFC 4122 兼容的多种 UUID 版本。
本文详解 hibernate 6 中弃用 `@genericgenerator + uuidgenerator.class` 组合后，如何通过标准注解 `@uuidgenerator` 正确配置 uuid 主键，避免类型不匹配错误，并支持 rfc 4122 兼容的多种 uuid 版本。
在 Hibernate 6 中，旧版 @GenericGenerator 配合 org.hibernate.id.uuid.UuidGenerator 的用法已被彻底重构。你遇到的错误：
Parameter 0 of constructor in org.hibernate.id.uuid.UuidGenerator required a bean of type 'org.hibernate.annotations.UuidGenerator' that could not be found
根本原因在于：UuidGenerator 类不再直接通过 type= 参数注入，而是必须由 @UuidGenerator 注解驱动——该注解内部通过 @IdGeneratorType(UuidGenerator.class) 显式绑定生成器实现，并由 Hibernate 自动完成依赖装配。手动指定 type = UuidGenerator.class 会绕过这一机制，导致 Spring/Hibernate 无法解析其构造参数（如 UuidGenerator 所需的 UuidGenerationStrategy 和元数据上下文），从而抛出 Bean 类型不匹配异常。
✅ 正确做法：直接使用 @UuidGenerator（自 Hibernate 6.0 起引入的标准注解）
import jakarta.persistence.Id;
import org.hibernate.annotations.UuidGenerator;
import java.util.UUID;
@Entity
public class Product {
@Id
@UuidGenerator // ✅ 简洁、安全、符合规范
private UUID id;
// 其他字段...
}
若需指定 UUID 版本（如基于时间的 Type 1 或随机的 Type 4），可进一步配置策略：
@Id @UuidGenerator(style = "time") // 生成 Type 1 UUID（基于时间戳+MAC） private UUID id;
支持的 style 值包括：
-
"random"（默认，Type 4，强随机性） -
"time"（Type 1，高排序性，适合索引优化） -
"string"（生成字符串形式的 UUID，字段类型需为String）
⚠️ 注意事项：
-
@UuidGenerator仅适用于UUID或String类型的主键字段，不可用于Long/Integer； - 不再需要
@GeneratedValue(strategy = GenerationType.AUTO)——@UuidGenerator已隐含标识生成语义； - 若字段声明为
String，生成的 UUID 将自动以标准格式（如"a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11"）存储：@Id @UuidGenerator(style = "random") private String id; // 存储为字符串
- 确保使用 Hibernate ORM 6.0+ 和 Jakarta EE 9+（即
jakarta.persistence.*，非javax.*）；
? 补充说明：Hibernate 6 引入了全新的 @IdGeneratorType 和标准化注解体系（如 @UuidGenerator, @JdbcGenerator, @SequenceGenerator），旨在替代已废弃的 IdentifierGenerator 接口和 @GenericGenerator。这不仅提升了类型安全性与可维护性，还为未来扩展（如数据库原生 UUID 支持）奠定了基础。
综上，请立即迁移至 @UuidGenerator —— 它更简洁、无配置陷阱、完全兼容 Hibernate 6 的生命周期管理，是生成 RFC 4122 UUID 的唯一推荐方式。
