Spring Boot中如何用@Entity与枚举类型实现角色持久化？

我想去掉助教用的ERole枚举，只用一个Role枚举/类来定义角色类型，同时要实现三个需求：

1. 自动创建role表
2. 自动向表中插入带唯一自增ID的角色数据
3. 为该枚举/类创建JpaRepository

我尝试给枚举MyRole加@Entity注解，但报了错：

org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'myRoleRepository' defined in org.example.springskeleton.user.MyRoleRepository defined in @EnableJpaRepositories declared on JpaRepositoriesRegistrar.EnableJpaRepositoriesConfiguration: Unable to make field private final java.lang.String java.lang.Enum.name accessible: module java.base does not "opens java.lang" to unnamed module @4988d8b8

查文档说@Entity可以用在枚举上，但没找到示例。现在有两个问题：

1. 助教的实现方式有没有更优的方案？
2. 我的枚举实体方案是否可行，或者说更优？

助教原代码 #

ERole枚举

public enum ERole {
    CUSTOMER,
    MANAGER,
    ADMIN
}

Role实体

@Entity
@RequiredArgsConstructor
@AllArgsConstructor
@Builder
@Data
public class Role {
    @Id
    @GeneratedValue( strategy = GenerationType.IDENTITY )
    private Integer id;

    @Enumerated( EnumType.STRING )
    @Column( length = 20 )
    private ERole name;
}

User实体（多对多关联Role）

@Entity
@Table ( uniqueConstraints = { @UniqueConstraint ( columnNames = { "username", "email" } ) } )
@RequiredArgsConstructor
@AllArgsConstructor
@Builder
@Data
public class User {

    @Id
    @GeneratedValue ( strategy = GenerationType.IDENTITY )
    private Long id;

    @Column ( nullable = false, length = 20 )
    private String username;

    @Column ( nullable = false, length = 50 )
    private String email;

    @Column ( nullable = false, length = 120 )
    private String password;

    @ManyToMany ( fetch = FetchType.LAZY )
    @JoinTable ( name = "user_roles",
            joinColumns = @JoinColumn ( name = "user_id" ),
            inverseJoinColumns = @JoinColumn ( name = "role_id" ) )
    private Set <Role> roles = new HashSet <> ( );
}

我的尝试代码 #

MyRole枚举

@Entity
public enum MyRole {
    CUSTOMER,
    MANAGER,
    ADMIN;

    @Id
    @GeneratedValue ( strategy = GenerationType.IDENTITY )
    private Integer id;
}

MyRoleRepository

public interface MyRoleRepository extends JpaRepository <MyRole, Integer> {
}

一、助教方案的优化空间 #

助教的枚举+实体类分离方案是Spring Boot处理角色的常规做法，本身没问题，但可以从以下几点优化：

1. 强化实体约束与简化注解 #

原Role实体可以补充字段约束，同时简化注解组合（JPA要求实体有无参构造，避免注解冲突）：

@Entity
@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class Role {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Integer id;

    @Enumerated(EnumType.STRING)
    @Column(length = 20, unique = true, nullable = false)
    private ERole name;
}

这里添加unique = true和nullable = false，保证角色名称唯一且非空，符合业务逻辑。

2. 自动初始化角色数据 #

用ApplicationRunner实现启动时自动插入角色数据，不用手动操作数据库：

@Component
public class RoleDataInitializer implements ApplicationRunner {

    private final RoleRepository roleRepository;

    public RoleDataInitializer(RoleRepository roleRepository) {
        this.roleRepository = roleRepository;
    }

    @Override
    public void run(ApplicationArguments args) throws Exception {
        Arrays.stream(ERole.values())
              .forEach(role -> {
                  if (!roleRepository.existsByName(role)) {
                      roleRepository.save(Role.builder().name(role).build());
                  }
              });
    }
}

3. 简化用户角色集合初始化 #

给User的roles字段加@Builder.Default，避免每次创建User都手动初始化集合：

@ManyToMany(fetch = FetchType.LAZY)
@JoinTable(name = "user_roles",
        joinColumns = @JoinColumn(name = "user_id"),
        inverseJoinColumns = @JoinColumn(name = "role_id"))
@Builder.Default
private Set<Role> roles = new HashSet<>();

二、你的枚举实体方案：可行性与优缺点 #

1. 报错原因 #

JPA需要反射访问枚举的name字段（这是java.lang.Enum的私有final字段），但Java 9+的模块系统默认禁止未命名模块访问java.lang的内部字段，因此抛出权限错误。

2. 是否可行？ #

如果硬要让方案运行，需要在JVM启动参数中添加：

--add-opens java.base/java.lang=ALL-UNNAMED

但这种做法不推荐，它打破了Java模块的封装性，会带来兼容性风险，后续JDK版本可能会限制这类操作。

3. 优缺点对比 #

优点：

• 减少类数量，只用一个枚举同时实现常量定义和数据库实体
• 代码更简洁，不用维护两个类

缺点：

• 违反单一职责原则：枚举本来是定义常量集合，现在还要承担数据库实体的职责
• 扩展性极差：如果后续要给角色加描述、权限列表等字段，枚举无法灵活扩展
• 依赖特殊JVM参数，部署和维护成本高
• 不符合Spring Boot常规实践，遇到问题很难找到参考案例

总结 #

助教的方案虽然多了一个枚举类，但更符合Spring Boot设计规范，扩展性强，维护成本低，优化后完全能满足你的需求。而你的枚举实体方案虽然简洁，但存在兼容性和扩展性硬伤，不建议在生产环境使用。

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