Hibernate自定义UUID类型映射如何全局设置char字段长度为36

问题根因 #

你自定义的UUIDType虽然覆写了尺寸相关方法，但Hibernate 5.4版本处理自定义基础类型的默认列长度时，会优先读取SQL类型描述符的默认长度，你当前使用的VarcharTypeDescriptor.INSTANCE默认长度固定为255，你定义的Size规则不会被优先应用。

可行解决方案 #

方案1：自定义SQL类型描述符指定默认长度（推荐）

首先定义专属的SQL类型描述符，覆写默认长度配置：

public class UUIDVarcharTypeDescriptor extends VarcharTypeDescriptor {
    public static final UUIDVarcharTypeDescriptor INSTANCE = new UUIDVarcharTypeDescriptor();

    @Override
    public Integer getDefaultLength() {
        return 36;
    }
}

修改UUIDType的构造方法，替换原有SQL类型描述符：

public UUIDType() {
    // 替换原来的VarcharTypeDescriptor.INSTANCE
    super(UUIDVarcharTypeDescriptor.INSTANCE, UUIDJavaDescriptor.INSTANCE);
}

如果你的业务场景更适合固定长度的CHAR类型（Oracle下固定长度字段的索引效率更高），可以把VarcharTypeDescriptor换成CharTypeDescriptor继承，效果完全一致。

方案2：全局注册自定义类型兜底

如果方案1不生效，可以通过Hibernate的MetadataBuilderContributor全局强制注册类型，优先级高于注解定义的@TypeDef：

1. 实现贡献器类：

public class UUIDTypeContributor implements MetadataBuilderContributor {
    @Override
    public void contribute(MetadataBuilder metadataBuilder) {
        metadataBuilder.applyBasicType(UUIDType.INSTANCE, UUIDType.NAME);
    }
}

2. 在项目的resources/META-INF/services目录下新建文件org.hibernate.boot.spi.MetadataBuilderContributor，文件内容为你实现的贡献器类的全限定类名即可。

修改完成后，移除原有UUID字段上的@Column(length = 36)配置，重新生成DDL就能看到所有UUID类型字段的默认长度已经调整为36。

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