JPA关联已存在权限仍触发重复注册报错求助

报错原因 #

当前代码的核心问题：

• 在Service层构建AccountAuthority时，直接通过Authority.builder().authorityName("ROLE_INSTITUTE").build()创建了一个瞬时态的Authority实例。
• 由于Account实体的authorities字段配置了cascade = CascadeType.ALL，执行accountRepository.save(account)时，JPA会级联处理所有关联实体，包括尝试插入这个新构建的Authority记录。
• 但数据库中已经存在authority_name为ROLE_INSTITUTE的权限记录，违反了authority_pkey的唯一约束，因此抛出duplicate key value错误。

解决方案 #

方案1：查询已存在的权限实例（推荐） #

注入AuthorityRepository，先从数据库查询出已存在的ROLE_INSTITUTE权限，再用这个持久化实例构建AccountAuthority，避免JPA尝试插入新的权限记录。

修改后的Service代码：

@Transactional
public Account joinByInputJoinAccount(InputJoinAccount inputJoinAccount) {
    // 查询数据库中已存在的权限
    Authority instituteAuthority = authorityRepository.findById("ROLE_INSTITUTE")
            .orElseThrow(() -> new IllegalArgumentException("权限ROLE_INSTITUTE不存在"));

    Account.AccountBuilder accountBuilder = Account.builder()
            .userid(inputJoinAccount.getUserid())
            .password(passwordEncoder.encode(inputJoinAccount.getPassword()))
            .name(inputJoinAccount.getName())
            .phoneNumber(inputJoinAccount.getPhoneNumber());

    if(StringUtils.isNotEmpty(inputJoinAccount.getBirthDate())) {
        accountBuilder.birthDate(LocalDate.parse(inputJoinAccount.getBirthDate()));
    }
    accountBuilder.activated(true);

    Account account = accountBuilder.build();
    // 使用查询到的持久化权限实例
    account.addAuthorities(Set.of(AccountAuthority.builder().authority(instituteAuthority).build()));

    return accountRepository.save(account);
}

方案2：调整级联操作类型（按需选择） #

如果不需要JPA级联创建Authority实体，可以修改Account类中@OneToMany的级联配置，移除CascadeType.PERSIST或CascadeType.ALL，替换为需要的级联类型（比如仅级联更新、删除）：

@OneToMany(mappedBy = "account", cascade = {CascadeType.MERGE, CascadeType.REMOVE})
private Set<AccountAuthority> authorities = new HashSet<>();

注意：此方案仅适用于不需要通过Account级联创建新权限的场景，若后续需要新增权限，需单独处理Authority的保存。

关键原理补充 #

JPA对实体的状态分为：瞬时态（transient，未被持久化）、持久态（persistent，已在数据库存在）、游离态（detached，曾持久化但当前不在会话中）。当级联操作触发时，JPA会对瞬时态实体执行插入操作，持久态实体则执行更新或关联操作。因此必须确保关联的是持久态的Authority实例，才不会触发重复插入。

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