如何定义同时兼容MySQL 8.4与H2的UUID身份列？

我正尝试实现一个使用UUID而非long作为身份列的数据库表。原long类型ID的实现运行良好，包括端到端的Spring MVC测试：

@Getter
@Setter
@Entity
@Table(name="myrecords")
public class myrecord {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private long id;
}

当我将表定义为使用UUID替代long作为身份列时：

@Getter
@Setter
@Entity
@Table(name="myrecords")
public class myrecord {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "id", columnDefinition = "BINARY(16) DEFAULT (UUID_TO_BIN(UUID()))")
    private UUID id;
}

应用在MySQL 8.4.3数据库上可正常运行，但原本基于H2内存数据库的测试现在失败了，因为H2不支持columnDefinition = "BINARY(16) DEFAULT (UUID_TO_BIN(UUID()))"。

为了同时适配生产环境的MySQL和测试环境的H2，我了解到可能需要将@GeneratedValue策略改为GenerationType.AUTO，或是为UUID使用自定义ID生成器（@GenericGenerator）。但这样做会失去MySQL 8对UUID的优化优势。请问定义UUID身份列时，兼顾MySQL 8.4与H2的推荐方案是什么？

以下是三种兼顾MySQL 8 UUID优化特性和H2测试兼容性的实用方案：

方案一：自定义数据库方言适配 #

通过扩展Hibernate方言，为MySQL和H2分别配置UUID列的生成逻辑：

1. 简化实体类注解，移除硬编码的columnDefinition：

@Getter
@Setter
@Entity
@Table(name="myrecords")
public class myrecord {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "id")
    private UUID id;
}

2. 自定义MySQL方言，确保使用MySQL优化的UUID存储规则：

public class CustomMySQLDialect extends MySQL8Dialect {
    @Override
    public String getTypeName(int code, long length, int precision, int scale) {
        if (code == Types.BINARY && length == 16) {
            return "BINARY(16) DEFAULT (UUID_TO_BIN(UUID()))";
        }
        return super.getTypeName(code, length, precision, scale);
    }
}

3. 自定义H2方言，适配H2支持的UUID语法：

public class CustomH2Dialect extends H2Dialect {
    @Override
    public String getTypeName(int code, long length, int precision, int scale) {
        if (code == Types.BINARY && length == 16) {
            return "UUID DEFAULT RANDOM_UUID()";
        }
        return super.getTypeName(code, length, precision, scale);
    }
}

4. 按环境切换方言配置：
   • 生产环境：spring.jpa.properties.hibernate.dialect=com.yourpackage.CustomMySQLDialect
   • 测试环境：spring.jpa.properties.hibernate.dialect=com.yourpackage.CustomH2Dialect

这种方式既能保留MySQL的UUID紧凑存储、索引友好的优化特性，又能让H2测试环境正常工作。

方案二：Spring Profiles隔离实体配置 #

通过Spring Profiles为不同环境提供独立的实体类定义：

1. 创建通用基础实体类：

@Getter
@Setter
@MappedSuperclass
public abstract class BaseMyRecord {
    // 其他通用字段和方法
}

2. 生产环境（MySQL）实体类：

@Profile("prod")
@Entity
@Table(name="myrecords")
public class MyRecord extends BaseMyRecord {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "id", columnDefinition = "BINARY(16) DEFAULT (UUID_TO_BIN(UUID()))")
    private UUID id;
}

3. 测试环境（H2）实体类：

@Profile("test")
@Entity
@Table(name="myrecords")
public class TestMyRecord extends BaseMyRecord {
    @Id
    @GeneratedValue(strategy = GenerationType.AUTO)
    @Column(name = "id")
    private UUID id;
}

4. 激活对应Profile：
   • 测试类添加@ActiveProfiles("test")
   • 生产环境配置spring.profiles.active=prod

这种方案逻辑直观，不同环境的实体配置完全隔离，避免了方言自定义的复杂度。

方案三：H2模拟MySQL UUID函数 #

开启H2的MySQL兼容模式，并自定义缺失的UUID函数：

1. 修改H2连接URL，开启兼容模式：

spring.datasource.url=jdbc:h2:mem:testdb;MODE=MYSQL;DB_CLOSE_DELAY=-1

2. 在测试初始化时创建自定义函数：

CREATE ALIAS IF NOT EXISTS UUID_TO_BIN FOR "com.yourpackage.H2UuidFunctions.uuidToBin";
CREATE ALIAS IF NOT EXISTS BIN_TO_UUID FOR "com.yourpackage.H2UuidFunctions.binToUuid";

3. 编写对应的Java函数实现：

public class H2UuidFunctions {
    public static byte[] uuidToBin(String uuid) {
        UUID parsedUuid = UUID.fromString(uuid);
        ByteBuffer buffer = ByteBuffer.wrap(new byte[16]);
        buffer.putLong(parsedUuid.getMostSignificantBits());
        buffer.putLong(parsedUuid.getLeastSignificantBits());
        return buffer.array();
    }

    public static String binToUuid(byte[] bytes) {
        ByteBuffer buffer = ByteBuffer.wrap(bytes);
        long mostSigBits = buffer.getLong();
        long leastSigBits = buffer.getLong();
        return new UUID(mostSigBits, leastSigBits).toString();
    }
}

这种方式无需修改实体类代码，直接在H2中模拟MySQL的UUID处理逻辑，让原配置在测试环境正常运行。

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