如何使用JPA创建ENUM数组列，实现PostgreSQL数组到枚举集合映射

问题根因 #

你现在使用的@ElementCollection注解默认采用关联表存储集合类型数据，JPA会自动生成/查询关联表（你报错里的theme_config_currency_options就是自动生成的关联表名），不符合你直接在当前表存储数组的需求。

解决方案 #

方案1：Hibernate 6+ 原生支持（推荐） #

Hibernate 6开始原生支持PostgreSQL数组类型，仅需添加@Array注解即可实现需求，不需要额外写转换器：

import org.hibernate.annotations.Array;
import jakarta.persistence.Enumerated;
import jakarta.persistence.EnumType;
import jakarta.persistence.Column;

// 字段定义
@Enumerated(EnumType.STRING)
@Array(value = String[].class)
@Column(name = "currency_options", columnDefinition = "varchar[]")
private Set<CurrencyDto> currencyOptions;

参数说明：

• @Array(value = String[].class)：指定数据库数组对应的Java数组类型，这里枚举以字符串形式存储，所以填String[].class
• columnDefinition = "varchar[]"：指定数据库列类型为PostgreSQL的字符串数组，开启JPA自动建表时会生成对应类型的列

方案2：自定义属性转换器（兼容Hibernate 5及其他JPA实现） #

如果你的JPA版本较低不支持原生数组注解，可以自定义转换器实现枚举集合和PostgreSQL数组的双向转换：

1. 先编写转换器类

import jakarta.persistence.AttributeConverter;
import jakarta.persistence.Converter;
import java.util.Arrays;
import java.util.Set;
import java.util.stream.Collectors;

@Converter(autoApply = false)
public class CurrencyDtoSetConverter implements AttributeConverter<Set<CurrencyDto>, String[]> {

    @Override
    public String[] convertToDatabaseColumn(Set<CurrencyDto> attribute) {
        if (attribute == null || attribute.isEmpty()) {
            return new String[0];
        }
        return attribute.stream()
                .map(Enum::name)
                .toArray(String[]::new);
    }

    @Override
    public Set<CurrencyDto> convertToEntityAttribute(String[] dbData) {
        if (dbData == null || dbData.length == 0) {
            return Set.of();
        }
        return Arrays.stream(dbData)
                .map(CurrencyDto::valueOf)
                .collect(Collectors.toSet());
    }
}

2. 字段上绑定转换器

import jakarta.persistence.Convert;
import jakarta.persistence.Column;

// 字段定义
@Convert(converter = CurrencyDtoSetConverter.class)
@Column(name = "currency_options", columnDefinition = "varchar[]")
private Set<CurrencyDto> currencyOptions;

注意事项 #

• 手动建表时需要确保对应字段的类型为varchar[]
• 如果你的枚举存储值不是默认的枚举名称，调整转换器里的读写逻辑匹配你的自定义存储值即可
• 若使用List代替Set存储枚举，仅需调整转换器里的返回类型和收集逻辑即可

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