如何修复Java 8 @ManyToMany关联中的重复键错误

根本原因 #

更新关联时触发重复主键错误，核心原因有两点：

• 直接操作非托管状态的User对象（比如DTO转换的实体）修改关联集合，Hibernate会直接执行INSERT语句，不会预先检查关联表中是否已存在该主键组合；
• 若未正确实现实体的equals()和hashCode()，Set集合无法识别重复的关联对象，导致重复添加操作。

最优修复方案（JPA规范兼容） #

1. 为实体实现正确的equals()和hashCode() #

Set集合依赖这两个方法判断对象是否重复，必须基于实体主键ID实现：
DAOTrackSystem.java

@Override
public boolean equals(Object o) {
    if (this == o) return true;
    if (o == null || getClass() != o.getClass()) return false;
    DAOTrackSystem that = (DAOTrackSystem) o;
    return Objects.equals(id, that.id);
}

@Override
public int hashCode() {
    return Objects.hash(id);
}

DAOUserRecord.java同理，基于userId实现equals和hashCode方法。

2. 操作持久化状态的实体集合 #

更新关联时，必须先从数据库加载托管状态的User对象，再直接修改其关联集合，而非替换整个集合：

@Transactional
public void updateUserAllowedTrackSystems(Long userId, Set<DAOTrackSystem> targetTrackSystems) {
    // 加载托管状态的User实体（Hibernate会自动跟踪其变化）
    DAOUserRecord user = entityManager.find(DAOUserRecord.class, userId);
    
    // 全量替换关联：先清空现有集合，再添加目标集合
    user.getAllowedTrackSystems().clear();
    user.getAllowedTrackSystems().addAll(targetTrackSystems);
    
    // 无需手动调用save/update，事务提交时Hibernate自动同步到数据库
}

原理说明

• 托管状态的实体，Hibernate会自动跟踪集合的增删变化；
• Set集合会基于equals/hashCode自动过滤重复的DAOTrackSystem对象；
• Hibernate只会执行必要的INSERT/DELETE语句，不会插入已存在的主键组合。

备选方案（数据库特定，适合批量操作） #

如果不想加载现有集合，可通过自定义SQL插入语句，让数据库忽略重复主键：

MySQL 版本 #

在User的@ManyToMany注解上添加@SQLInsert：

@ManyToMany(fetch = FetchType.LAZY)
@JoinTable(
    name = "user_track_systems",
    joinColumns = @JoinColumn(name = "user_id"),
    inverseJoinColumns = @JoinColumn(name = "track_system_id")
)
@SQLInsert(sql = "INSERT IGNORE INTO user_track_systems (user_id, track_system_id) VALUES (?, ?)")
private Set<DAOTrackSystem> allowedTrackSystems;

PostgreSQL 版本 #

@SQLInsert(sql = "INSERT INTO user_track_systems (user_id, track_system_id) VALUES (?, ?) ON CONFLICT DO NOTHING")

优缺点

• 优点：无需加载现有集合，适合批量更新场景；
• 缺点：依赖数据库特定语法，跨数据库兼容性差，无法自动处理关联移除操作。

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