Spring Boot 3.x中JPA/Hibernate存储UUID为字符串报错咨询

问题原因 #

Spring Boot 3.x 升级后配套使用的 Hibernate 6.x 重构了类型映射系统，同时完全切换到 Jakarta EE API：

• 原 org.hibernate.annotations.Type 注解的 type 参数被移除，改为 value 参数
• 原 org.hibernate.type.UUIDCharType 类已被重命名为 org.hibernate.type.SqlUUIDCharType

这直接导致你原来的注解写法失效，出现Cannot resolve method 'type'错误。

解决方案 #

以下三种方式都可以解决问题，按需选择：

方案一：移除 @Type 注解（最简方式） #

Hibernate 6.x 已能自动识别 UUID 类型，并根据 @Column 的 columnDefinition 配置将其映射为 VARCHAR 字符串，无需额外注解：

@Id
@Column(columnDefinition = "VARCHAR(255)")
private UUID id;

方案二：使用 Hibernate 6.x 新版 @Type 注解 #

导入正确的类型类后，用 value 参数指定类型：

import jakarta.persistence.*;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;
import org.hibernate.annotations.Type;
import org.hibernate.type.SqlUUIDCharType;

import java.util.UUID;

@Data
@Entity
@Table(name = "werkstatt")
@AllArgsConstructor
@NoArgsConstructor
@Builder
public class WerkstattEntity {

    @Id
    @Column(columnDefinition = "VARCHAR(255)")
    @Type(value = SqlUUIDCharType.class)
    private UUID id;
}

方案三：使用 JPA 标准注解 @JdbcTypeCode #

采用 Jakarta EE 提供的标准注解，兼容性更好：

import jakarta.persistence.*;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;

import java.util.UUID;

@Data
@Entity
@Table(name = "werkstatt")
@AllArgsConstructor
@NoArgsConstructor
@Builder
public class WerkstattEntity {

    @Id
    @Column(columnDefinition = "VARCHAR(255)")
    @JdbcTypeCode(SqlTypes.VARCHAR)
    private UUID id;
}

注意事项 #

你的 Gradle 依赖配置无需额外调整，Spring Boot 3.x 的 spring-boot-starter-data-jpa 已经包含了适配的 Hibernate 版本，不需要手动添加 Hibernate 相关依赖。

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