如何从数据库端解决遗留系统中UUID与VARCHAR(36)的Hibernate转换问题？

方案1：统一数据库中UUID字符串的标准格式 #

Hibernate无法将VARCHAR(36)转换为UUID，大概率是数据库中存储的字符串不符合标准UUID格式（即带横杠的36位字符串，如550e8400-e29b-41d4-a716-446655440000）。你可以：

• 先检查现有数据的格式，比如是否存在无横杠、大小写不统一的情况；
• 执行SQL批量修正数据，例如将无横杠的32位字符串插入横杠：

  UPDATE 表名 
  SET id = CONCAT(
      SUBSTRING(id, 1, 8), '-',
      SUBSTRING(id, 9, 4), '-',
      SUBSTRING(id, 13, 4), '-',
      SUBSTRING(id, 17, 4), '-',
      SUBSTRING(id, 21)
  )
  WHERE CHAR_LENGTH(id) = 32; -- 针对无横杠的32位UUID字符串
  

修正后，Hibernate的@Type(type="string")就能正常将字符串映射为UUID类型。

方案2：重新尝试修改数据库列类型为UUID（正确处理数据转换） #

你之前尝试改数据库类型但可能未正确处理现有数据的转换。不同数据库有对应的语法可以直接将符合格式的VARCHAR字符串转换为UUID类型：

• PostgreSQL：

  ALTER TABLE 表名 ALTER COLUMN id TYPE uuid USING id::uuid;
  

• MySQL（8.0+支持UUID类型）：

  ALTER TABLE 表名 MODIFY COLUMN id BINARY(16);
  

执行前确保所有数据都是标准UUID字符串，这样数据库会自动完成数据转换，无需将值设为NULL，也就不会出现加载不到记录的问题。

方案3：自定义Hibernate类型转换器（备选，代码端小改动） #

如果数据库格式无法调整，可以在Java代码中添加自定义类型转换逻辑，无需大规模修改代码：

import org.hibernate.type.UUIDCharType;
import org.hibernate.type.descriptor.WrapperOptions;
import java.util.UUID;

public class CustomUUIDType extends UUIDCharType {
    @Override
    public String toString(UUID value) {
        return value != null ? value.toString() : null;
    }

    @Override
    public UUID fromString(String string) {
        return string != null ? UUID.fromString(string) : null;
    }

    @Override
    public <X> X unwrap(UUID value, Class<X> type, WrapperOptions options) {
        return getSqlTypeDescriptor().unwrap(toString(value), type, options);
    }

    @Override
    public <X> UUID wrap(X value, WrapperOptions options) {
        String str = getSqlTypeDescriptor().wrap(value, options);
        return fromString(str);
    }
}

然后在实体类中替换@Type注解：

@Column(name="ID")
@Type(type="com.yourpackage.CustomUUIDType")
private UUID id;

这个改动仅需新增一个类并修改注解，代码改动量极小。

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