Spring Boot中JPA/Hibernate如何存储EnumSet？

要在Spring Boot + JPA/Hibernate中把EnumSet<Rights>作为位掩码存储到MariaDB，且无需自定义转换器，可以利用Hibernate的内置类型支持，分两种版本场景处理：

场景1：使用Hibernate 6.x（对应Spring Boot 3.x及以上） #

直接使用Hibernate 6引入的注解实现开箱即用：

1. 保持Rights枚举定义不变：

public static enum Rights { R, W, X };

2. 给rights字段添加如下注解：

@NotNull
@Column(columnDefinition = "INT") // 若枚举值数量超过31，可改为BIGINT
@JdbcTypeCode(SqlTypes.INTEGER)
@JavaType(EnumSetJavaType.class)
private EnumSet<Rights> rights;

• @JdbcTypeCode(SqlTypes.INTEGER)指定数据库存储类型为整数
• @JavaType(EnumSetJavaType.class)让Hibernate用内置处理器自动完成EnumSet与位掩码整数的双向转换

场景2：使用Hibernate 5.x（对应Spring Boot 2.x） #

使用Hibernate 5的@Type注解配合内置类型：

1. 保持Rights枚举定义不变
2. 给rights字段添加注解：

@NotNull
@Column(columnDefinition = "INT")
@Type(type = "org.hibernate.type.EnumSetType", parameters = {
    @Parameter(name = "enumClass", value = "com.yourpackage.MyFile$Rights")
})
private EnumSet<Rights> rights;

• 替换com.yourpackage.MyFile$Rights为你实际的类全路径（内部枚举需用$连接）
• 该类型会自动将EnumSet转换为对应位掩码整数存储，查询时反向转换

关键说明 #

• MariaDB字段类型：INT足够存储最多31个枚举值的位掩码，枚举值超过31个时改用BIGINT
• 存储逻辑：例如EnumSet.of(Rights.R, Rights.W)会被存储为3（二进制11），EnumSet.of(Rights.X)存储为4（二进制100），完全符合位掩码需求
• 全程无需编写自定义转换器，转换逻辑由Hibernate内置类型处理

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