JPA多对多关联中连接表未插入记录问题排查

我在JPA中配置了User与Role的Many-to-Many关联关系。保存实体时，User和Role均已成功持久化到对应表，但连接表user_roles中未插入关联记录。以下是实体类及客户端代码，请问问题出在哪里？

User实体 #

@Entity
@Table(name="users")
@Data
@NoArgsConstructor
@EqualsAndHashCode(exclude = "roles")
@ToString(exclude = "roles")
public class User {
    
    @Id
    @GeneratedValue(strategy = GenerationType.AUTO)
    private long id;
    
    private String name;
    private String password;
    private double salary;
    
    public User(String name, String password, double salary) {
        super();
        this.name = name;
        this.password = password;
        this.salary = salary;
    }
    
    
    @ManyToMany(
            mappedBy = "users")
    private Set<Role> roles = new HashSet<>();
    
    
    public void addRole(Role role) {
        this.roles.add(role);
        role.getUsers().add(this);
    }
}

Role实体 #

@Entity
@Table(name = "roles")
@Data
@NoArgsConstructor
@EqualsAndHashCode(exclude = "users")
@ToString(exclude = "users")
public class Role {
    @Id
    @GeneratedValue(strategy = GenerationType.AUTO)
    private int id;
    private String roleName;

    public Role(String roleName) {
        super();
        this.roleName = roleName;
    }
    
    @ManyToMany
    @JoinTable(
            name="user_roles",
            joinColumns = @JoinColumn(name="role_id", nullable = false),
            inverseJoinColumns = @JoinColumn(name="user_id", nullable = false)
            )
    private Set<User> users = new HashSet<>();
}

客户端代码 #

@EventListener(ApplicationReadyEvent.class)
public void onApplicationStartup(ApplicationReadyEvent event) {
    
    User kiran = new User("kiran", this.passwordEncoder.encode("welcome"), 4500000);
    
    User vinay = new User("vinay", this.passwordEncoder.encode("welcome"), 4500000);        
    
    Role userRole = new Role("ROLE_USER");
    
    Role adminRole = new Role("ROLE_ADMIN");
    
    
    kiran.addRole(userRole);
    
    vinay.addRole(userRole);
    vinay.addRole(adminRole);
    
    this.userRepository.save(kiran);
    this.userRepository.save(vinay);
    
}

问题原因 #

JPA多对多关联分为维护端（Owner Side）和反向端（Inverse Side）：

• 当前配置中，Role是维护端（标注了@JoinTable，无mappedBy属性）
• User是反向端（标注了mappedBy="users"，指向Role的users集合）

JPA只会同步维护端的关联关系到数据库，反向端的集合变更不会触发连接表的更新。你当前只保存了作为反向端的User实体，因此连接表user_roles中不会生成关联记录。

解决方案 #

方案1：保存维护端实体（Role） #

因为Role是维护端，需要确保关联的Role实体被保存，JPA会同步其users集合的变更到连接表。修改客户端代码：

@EventListener(ApplicationReadyEvent.class)
public void onApplicationStartup(ApplicationReadyEvent event) {
    
    User kiran = new User("kiran", this.passwordEncoder.encode("welcome"), 4500000);
    User vinay = new User("vinay", this.passwordEncoder.encode("welcome"), 4500000);        
    
    Role userRole = new Role("ROLE_USER");
    Role adminRole = new Role("ROLE_ADMIN");
    
    kiran.addRole(userRole);
    vinay.addRole(userRole);
    vinay.addRole(adminRole);
    
    // 先保存用户（可选，保存Role时级联也能处理）
    this.userRepository.save(kiran);
    this.userRepository.save(vinay);
    
    // 保存维护端Role，触发连接表更新
    this.roleRepository.save(userRole);
    this.roleRepository.save(adminRole);
}

方案2：切换维护端为User（更贴合业务逻辑） #

如果业务上用户是关联关系的主导方，希望通过保存User自动同步连接表，可以调整关联配置：

1. 修改User实体的@ManyToMany注解，设置为维护端：

@ManyToMany
@JoinTable(
        name="user_roles",
        joinColumns = @JoinColumn(name="user_id", nullable = false),
        inverseJoinColumns = @JoinColumn(name="role_id", nullable = false)
)
private Set<Role> roles = new HashSet<>();

2. 修改Role实体的@ManyToMany注解，设置为反向端：

@ManyToMany(mappedBy = "roles")
private Set<User> users = new HashSet<>();

调整后，原客户端代码无需修改，保存User时JPA会自动更新连接表记录。

补充说明 #

你的addRole方法实现正确，已经同时维护了双向关联的两边，避免了内存中关联关系不一致的问题。无论采用哪种方案，都要确保维护端实体处于JPA的持久化上下文管理中（即调用save方法）。

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