Hibernate主键从String改为UUID后相似ID实体覆盖碰撞问题

问题根因解释 #

1. 数据库ID存储格式变化原因 #

当你把实体主键从String类型改为java.util.UUID类型后，JPA（默认Hibernate实现）的默认字段映射逻辑发生了变化：

• 原String类型场景：Hibernate直接持久化UUID.toString()的输出结果，即带横杠的36位标准UUID字符串格式。
• 现UUID类型场景：未明确指定列映射规则时，Hibernate默认会将UUID对象序列化为16字节的二进制数据，再转为32位无分隔符的大写十六进制字符串存储，就会出现你观察到的格式变化。

2. ID碰撞、两条记录返回一条的原因 #

这个问题的核心是JPA的UUID转换器对数据库现有字符串格式ID的解析逻辑异常，加上JPA持久化上下文的主键去重机制共同导致的：

• 你之前手动插入的两条记录ID是带横杠的36位字符串格式，而当前Hibernate默认按照二进制UUID的逻辑读取字段内容：如果你的数据库ID字段还是字符串类型，转换器会直接读取字符串的字节内容，截断前16字节来构造UUID对象。你提到的两个ID只有最后一位不同，前16字节内容完全一致，最终解析出来的UUID对象也完全相同。
• JPA的持久化上下文（一级缓存）默认以主键的equals()结果作为实体唯一判定标准，当查询返回两条数据库记录时，JPA解析得到的主键UUID相同，就会判定为同一个实体，后读取的记录会覆盖先读取的记录，最终只会返回最后一条记录的内容，整个过程不会抛出异常。

修复方案 #

• 如果要保留原有字符串格式的ID存储：给主键字段添加明确的类型映射注解，指定用字符串格式和UUID互转，Hibernate场景下配置为：

@Id
@Column(columnDefinition = "VARCHAR(36)")
@Type(type = "org.hibernate.type.UUIDCharType")
private UUID id;

• 如果要使用二进制UUID存储：先把数据库中所有存量的36位字符串ID批量转换为16字节的二进制格式，再上线修改后的代码，避免解析异常。
• 后续手动插入数据时，要保证插入的ID格式和JPA的序列化格式完全一致，避免出现解析错误。

内容的提问来源于stack exchange，提问作者Μenelaοs