Spring Boot JPA一对多关联：重复邮箱覆盖问题解决方案咨询

你的问题核心在于：当保存包含已存在邮箱地址的User实体时，Hibernate的save()方法会将该邮箱对应的记录更新为新用户的ID，而非抛出重复冲突异常。这是因为save()的逻辑是：若实体主键已存在则执行更新，否则执行插入——而EmailAddress的主键是email_address，当邮箱已在库中存在时，save()就会触发更新覆盖原有user_id。

下面是几种按优先级排序的最佳处理方案：

1. 改用persist()替代save()，利用JPA的实体存在校验 #

JPA的persist()和save()核心差异在于：

• persist()仅负责新建实体的插入，若实体主键已存在（即邮箱已被占用），会直接抛出EntityExistsException。
• save()则会根据主键是否存在自动选择插入/更新，这正是导致你问题的根源。

修改你的持久化方法：

@Override
public T createEntity(T entity) {
    // 改用Session的persist方法
    this.em.unwrap(Session.class).persist(entity);
    // 或者直接使用EntityManager的persist
    // this.em.persist(entity);
    return entity;
}

此时若保存含已存在邮箱的用户，Hibernate会抛出EntityExistsException，你可以在业务层捕获该异常，转换成自定义业务异常（如DuplicateEmailException），再返回用户友好提示。

2. 捕获数据库唯一约束异常，转为业务提示 #

即便用了persist()，并发场景下（比如两个请求同时插入同一邮箱），数据库仍会因主键唯一约束抛出SQLIntegrityConstraintViolationException。你需要在业务层或全局异常处理器中捕获该异常，转成用户易懂的提示。

步骤1：创建自定义业务异常 #

public class DuplicateEmailException extends RuntimeException {
    public DuplicateEmailException(String message) {
        super(message);
    }
}

步骤2：业务层捕获异常并转换 #

@Service
public class UserService {
    @Autowired
    private UserRepository userRepository;

    public User createUser(User user) {
        try {
            return userRepository.createEntity(user);
        } catch (EntityExistsException e) {
            throw new DuplicateEmailException("邮箱地址已被使用");
        } catch (PersistenceException e) {
            // 捕获数据库层面的约束冲突
            if (e.getCause() instanceof SQLIntegrityConstraintViolationException) {
                throw new DuplicateEmailException("邮箱地址已被使用");
            }
            throw e;
        }
    }
}

步骤3：全局异常处理器返回提示 #

@RestControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(DuplicateEmailException.class)
    public ResponseEntity<String> handleDuplicateEmail(DuplicateEmailException e) {
        return ResponseEntity.badRequest().body(e.getMessage());
    }
}

3. 保存前主动检查邮箱是否存在（辅助手段） #

你可以在保存用户前，先查询数据库是否已存在该邮箱，提前抛出异常。但注意：这只能作为辅助，不能替代数据库的唯一约束——并发场景下可能出现“检查时不存在，插入时已存在”的情况，数据库约束才是最后一道防线。

示例代码：

@Service
public class UserService {
    @Autowired
    private EmailAddressRepository emailAddressRepository;

    public User createUser(User user) {
        // 遍历检查所有邮箱是否已被占用
        for (EmailAddress email : user.getEmailAddresses()) {
            if (emailAddressRepository.existsById(email.getEmailAddress())) {
                throw new DuplicateEmailException("邮箱地址 " + email.getEmailAddress() + " 已被使用");
            }
        }
        // 执行保存操作
        return userRepository.createEntity(user);
    }
}

额外优化：修正实体类的关联映射 #

你的EmailAddress实体中，关联User的字段命名存在语义混淆：

@ManyToOne
@JoinColumn(name = "user_id", referencedColumnName = "id")
private User userId; // 字段名应为user，而非userId

建议修改为：

@ManyToOne
@JoinColumn(name = "user_id", referencedColumnName = "id")
private User user;

同时同步修改User实体中的映射：

@OneToMany(mappedBy = "user", cascade = CascadeType.ALL, orphanRemoval = true)
@Size(min = 1)
private List<EmailAddress> emailAddresses;

这样代码可读性更强，避免字段名与关联关系混淆。

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