如何使用Spring Data JPA高效自动向关联映射表插入数据

前置说明 #

你当前提供的表结构存在冗余设计：User、Role表携带的userRoleId字段无需保留，多对多关联场景下仅需中间表UserRole存储关联关系即可，避免后续出现数据不一致问题。以下给出两种常用实现方案：

方案1：JPA多对多注解自动维护（推荐，无需手动操作中间表） #

通过JPA自带的多对多关联注解配置，完全不需要手动编写中间表的增删逻辑，框架会自动完成映射表的数据插入。

步骤1：配置实体类关联注解 #

// User实体类
@Entity
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String name;
    private String email;

    // 配置多对多关联
    @ManyToMany(cascade = {CascadeType.PERSIST, CascadeType.MERGE})
    @JoinTable(
        name = "user_role", // 你的中间表表名
        joinColumns = @JoinColumn(name = "user_id"), // 中间表指向User的外键字段名
        inverseJoinColumns = @JoinColumn(name = "role_id") // 中间表指向Role的外键字段名
    )
    private List<Role> roles = new ArrayList<>();

    // 关联维护工具方法，避免手动操作集合出错
    public void addRole(Role role) {
        roles.add(role);
        role.getUsers().add(this);
    }
    // 省略getter、setter、构造器
}

// Role实体类
@Entity
public class Role {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String name;

    // 反向关联，mappedBy指定关联关系由User侧的roles属性维护
    @ManyToMany(mappedBy = "roles")
    private List<User> users = new ArrayList<>();
    // 省略getter、setter、构造器
}

步骤2：业务代码调用 #

仅需要关联User和Role对象，保存User时JPA会自动往中间表插入关联数据：

// 示例：给id为1的用户绑定管理员角色
User user = userRepository.findById(1L).orElseThrow();
Role adminRole = roleRepository.findByName("ADMIN").orElseThrow();
// 关联两个对象
user.addRole(adminRole);
// 保存User，自动触发中间表插入，无需额外操作
userRepository.save(user);

方案2：手动维护中间表实体（适合中间表需要扩展额外字段的场景） #

如果后续需要在UserRole表添加关联时间、操作人等额外字段，可以把中间表定义为独立实体手动操作：

步骤1：定义中间表实体 #

@Entity
@Table(name = "user_role")
public class UserRole {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private Long userId;
    private Long roleId;
    // 可自由扩展其他字段
    private LocalDateTime createTime;
    // 省略getter、setter、构造器
}

步骤2：调用插入逻辑 #

// 单条插入
UserRole relation = new UserRole(null, 1L, 1L, LocalDateTime.now());
userRoleRepository.save(relation);

// 批量插入（性能更高）
List<UserRole> relationList = Arrays.asList(
    new UserRole(null, 1L, 1L, LocalDateTime.now()),
    new UserRole(null, 1L, 2L, LocalDateTime.now())
);
userRoleRepository.saveAll(relationList);

性能优化配置 #

批量插入场景下可在配置文件开启批量提交，大幅提升插入效率：

spring:
  jpa:
    properties:
      hibernate:
        jdbc:
          batch_size: 50 # 每攒50条SQL提交一次
        order_inserts: true # 排序插入语句适配批量提交
        order_updates: true

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