如何在Spring Boot+Hibernate中为JPA实体使用类型化ID？

你的思路非常靠谱——通过嵌套Record封装Long类型的ID，能从编译层面避免不同实体ID的混淆（比如把Order的ID误传给User相关方法），大幅提升代码的类型安全性和可读性。

不过直接使用你给出的代码，Hibernate可能无法正确映射这个自定义ID类型，需要根据你的Hibernate版本做一些调整：

方案1：兼容Hibernate 5及以上（通用方案） #

添加一个属性转换器，让Hibernate能在自定义ID类型和数据库列之间转换：

@Entity
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "id")
    @Convert(converter = UserIdConverter.class)
    private Id id;

    // 实体其他字段、构造方法、Getter/Setter等

    // 嵌套Record，封装User专属ID
    public record Id(Long value) implements Serializable {}

    // 自定义属性转换器
    public static class UserIdConverter implements AttributeConverter<User.Id, Long> {
        @Override
        public Long convertToDatabaseColumn(User.Id id) {
            return id != null ? id.value() : null;
        }

        @Override
        public User.Id convertToEntityAttribute(Long dbValue) {
            return dbValue != null ? new User.Id(dbValue) : null;
        }
    }
}

方案2：Hibernate 6+简化方案 #

Hibernate 6对Java Record有更好的原生支持，单一组件的Record可以直接被映射，无需额外转换器：

@Entity
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Id id;

    // 实体其他字段、构造方法、Getter/Setter等

    public record Id(Long id) {}
}

这种实现的核心优势 #

• 编译期类型检查：如果尝试将其他实体的ID（比如Order.Id）传入需要User.Id的方法，编译器会直接报错，避免运行时错误。
• 语义更清晰：代码中User.Id明确表示这是用户实体的专属ID，比单纯的Long更具可读性。
• 易于扩展：未来如果需要将ID类型从Long改为UUID或其他类型，只需修改Record的组件类型，无需改动所有使用User.Id的方法参数。

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