Spring Data JPA Hibernate 一对多关联保存关联表重复条目问题如何解决

问题根因 #

你当前的配置隐含了每个UserRole只能属于一个User的约束，这是引发关联表重复条目的核心原因：
你使用@OneToMany + @JoinTable配置关联时，Hibernate会默认给关联表user_roles的roleId字段添加唯一约束，因为@OneToMany的语义是「一个用户对应多个角色，单个角色只能归属于一个用户」。当你给第二个用户分配已经被第一个用户使用过的roleId时，就会触发roleId的唯一约束冲突，抛出重复条目异常。

解决方案 #

场景1：业务允许同一个角色分配给多个用户（绝大多数业务的实际需求） #

这属于典型的多对多关联，直接把User类中的@OneToMany注解替换为@ManyToMany即可：

public class User {
    @Id
    @GeneratedValue
    private long id;

    @Column(unique = true)
    private String username;
    private String password;

    // 替换为@ManyToMany
    @ManyToMany(fetch=FetchType.EAGER)
    @JoinTable(
        name = "user_roles",
        joinColumns = {@JoinColumn(name="userId")},
        inverseJoinColumns = {@JoinColumn(name="roleId")}
    )
    private Collection<UserRole> roles;
}

修改后关联表的唯一约束会变为(userId, roleId)联合唯一，只要同一个用户不重复绑定同一个角色，就不会触发冲突，支持多个用户绑定同一个角色。

场景2：业务确实要求单个角色只能属于一个用户 #

这种场景不需要用中间关联表，直接在UserRole表中增加user_id外键字段关联User即可，调整配置如下：

1. 移除User类中的@JoinTable配置：

public class User {
    @Id
    @GeneratedValue
    private long id;

    @Column(unique = true)
    private String username;
    private String password;

    @OneToMany(fetch=FetchType.EAGER, mappedBy = "user")
    private Collection<UserRole> roles;
}

2. 在UserRole类中增加关联User的字段：

public class UserRole {
    @Id
    @GeneratedValue
    private long id;

    @Column(unique = true)
    private String roleName;

    @ManyToOne
    @JoinColumn(name = "user_id")
    private User user;
}

这种配置下每个角色只能绑定一个用户，自然不会出现关联表重复条目的问题。

额外注意事项 #

• 如果需要级联保存/更新角色，建议在关联注解中添加合适的cascade属性，同时关联已存在的角色时，优先从数据库查询持久态对象再绑定，不要直接构造只有id的游离对象，避免不必要的插入异常。
• 调整配置后建议删除旧的关联表，让ORM框架自动重新生成表结构，避免旧的约束残留引发问题。

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