PostgreSQL中ERole枚举值未存入数据库致用户角色异常

注册新用户时返回角色数量为0，核心原因并非@Enumerated(EnumType.STRING)注解的使用问题——该注解仅定义枚举的数据库持久化格式，不会自动将枚举值插入到Role表中。Role表为空是因为缺少初始化数据，且注册流程未正确关联已持久化的Role实例。

1. 预先初始化Role表数据 #

你需要手动向Role表插入枚举对应的记录，以下是两种常用方式：

方式一：SQL初始化脚本 #

在src/main/resources下创建data.sql文件，写入初始化SQL：

INSERT INTO roles (role) VALUES ('ROLE_USER'), ('ROLE_MODERATOR'), ('ROLE_ADMIN');

Spring Boot会在项目启动时自动执行该脚本，可通过spring.sql.init.mode=always配置控制执行时机（根据生产/开发环境调整）。

方式二：Spring Bean初始化数据 #

创建初始化类，在项目启动时自动插入枚举数据：

@Component
public class RoleDataInitializer implements ApplicationListener<ContextRefreshedEvent> {

    private final RoleRepository roleRepository;

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

    @Override
    public void onApplicationEvent(ContextRefreshedEvent event) {
        // 避免重复初始化
        if (roleRepository.count() == 0) {
            Arrays.stream(ERole.values())
                  .map(Role::new)
                  .forEach(roleRepository::save);
        }
    }
}

2. 修正用户注册逻辑 #

注册新用户时，必须从数据库查询已持久化的Role实例，再关联到User对象，不能直接新建未保存的Role对象（无ID的Role无法完成多对多关联）。

示例注册逻辑：

@Service
public class UserService {

    private final UserRepository userRepository;
    private final RoleRepository roleRepository;

    public UserService(UserRepository userRepository, RoleRepository roleRepository) {
        this.userRepository = userRepository;
        this.roleRepository = roleRepository;
    }

    public User registerUser(String username, String password) {
        User user = new User(username, password);
        // 查询已存在的默认角色
        Role defaultRole = roleRepository.findByRole(ERole.ROLE_USER)
                .orElseThrow(() -> new RuntimeException("默认角色未初始化"));
        user.getRoles().add(defaultRole);
        return userRepository.save(user);
    }
}

3. 检查多对多关联的级联配置 #

你的User实体中多对多关联使用了CascadeType.ALL，但Role是关联关系的mappedBy方（Role实体中@ManyToMany(mappedBy="roles")），因此User的级联操作不会作用于Role。这意味着如果注册时直接添加未持久化的Role，JPA不会自动将其保存到数据库，最终导致关联失败。

必须确保Role先被持久化，再关联到User对象。

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