如何在H2数据库中持久化自定义枚举并正确配置INIT参数？

问题场景 #

现有如下实体类Test和自定义枚举Blah，使用Spring Boot+H2数据库时，无法初始化包含枚举字段的表：

Test实体类代码 #

@Entity
@Table(name = "TEST", schema = "KAA")
public class Test implements Serializable {

    @Id
    @Column(name = "ID", columnDefinition = "uuid", unique = true)
    private UUID id;

    @Column(name = "name", columnDefinition = "name")
    private String name;

    @Column(name = "blah", columnDefinition = "enum??")
    private Blah blah = Blah.A;

    // 省略其他代码
}

Blah枚举代码 #

public enum Blah {

    A("A"),
    B("B");

    private final String name;

    private Blah(String s) {
        name = s;
    }

    public String toString() {
        return this.name;
    }
}

当前Spring Boot配置 #

spring.datasource.url=jdbc:h2:mem:testdb;INIT=CREATE SCHEMA IF NOT EXISTS KAA
spring.datasource.driverClassName=org.h2.Driver
spring.datasource.username=sa
spring.datasource.password=password
spring.jpa.database-platform=org.hibernate.dialect.H2Dialect
spring.h2.console.enabled=true

尝试通过追加INIT命令创建枚举类型时遇到问题：

• 重复写INIT=参数：jdbc:h2:mem:testdb;INIT=CREATE SCHEMA IF NOT EXISTS KAA;INIT=CREATE DOMAIN IF NOT EXISTS enum as VARCHAR(255)，提示INIT参数重复
• 用逗号分隔命令：jdbc:h2:mem:testdb;INIT=CREATE SCHEMA IF NOT EXISTS KAA,INIT=CREATE DOMAIN IF NOT EXISTS enum as VARCHAR(255)，提示SQL语法错误

解决方案 #

1. 正确编写INIT参数的方式 #

H2的INIT参数支持在同一个值里写多个SQL语句，但需要用转义分号（\\;）分隔，因为URL中的普通分号是参数分隔符。示例：

spring.datasource.url=jdbc:h2:mem:testdb;INIT=CREATE SCHEMA IF NOT EXISTS KAA\\;CREATE DOMAIN IF NOT EXISTS KAA.BLAH_ENUM AS VARCHAR(255) CHECK (VALUE IN ('A', 'B'))

• 建议给自定义Domain起具体名称（如BLAH_ENUM），避免使用enum这类关键字
• 加上CHECK约束可以限定存储值的范围，更贴合枚举的特性
• 注意指定Schema（KAA.BLAH_ENUM），确保Domain创建在目标Schema下

之后实体类的字段可以指定该Domain：

@Column(name = "blah", columnDefinition = "BLAH_ENUM")
private Blah blah = Blah.A;

2. H2处理枚举的通用方案 #

方案一：使用JPA原生注解映射

直接在枚举字段上添加@Enumerated注解，指定存储类型为字符串，无需手动创建Domain：

@Enumerated(EnumType.STRING)
@Column(name = "blah")
private Blah blah = Blah.A;

• EnumType.STRING会存储枚举的常量名（如A/B），和你的toString()返回值一致，刚好匹配需求
• Hibernate会自动将字段映射为H2的VARCHAR类型，无需额外数据库配置

方案二：自定义AttributeConverter（灵活适配复杂场景）

如果枚举的存储值和常量名不一致，或者需要自定义转换逻辑，可以编写转换器：

import jakarta.persistence.AttributeConverter;
import jakarta.persistence.Converter;

@Converter(autoApply = true)
public class BlahConverter implements AttributeConverter<Blah, String> {
    @Override
    public String convertToDatabaseColumn(Blah attribute) {
        return attribute == null ? null : attribute.toString();
    }

    @Override
    public Blah convertToEntityAttribute(String dbData) {
        if (dbData == null) return null;
        for (Blah b : Blah.values()) {
            if (b.toString().equals(dbData)) {
                return b;
            }
        }
        throw new IllegalArgumentException("未知枚举值: " + dbData);
    }
}

• autoApply = true会自动应用到所有Blah类型的字段上
• 这种方式完全由代码控制转换逻辑，无需依赖数据库的Domain配置

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