如何避免JPA向ManyToMany集合添加条目时产生不必要的查询

• 你遇到的多余查询本质是Kotlin data class 自动生成的equals()/hashCode()方法触发了懒加载字段加载：
  1. 你的GroupEntity的users集合用HashSet实现，调用add()/remove()方法时，需要计算新元素的哈希值，同时和集合内已有元素做等值比对，会调用UserEntity的hashCode()和equals()方法
  2. Kotlin data class默认会把所有声明的属性纳入equals()/hashCode()的计算逻辑，而UserEntity的interests、badges是@ElementCollection注解的集合，默认使用懒加载策略，被调用时就会触发单独的数据库查询
  3. 集合内有多少个用户，就会触发多少次对应字段的查询，也就是你看到的批量SQL。

方案1：重写实体的equals和hashCode方法（推荐，对现有代码改动最小） #

仅用主键生成equals()和hashCode()，避免触碰懒加载的关联字段，JPA实体主键是唯一标识，用主键做等值判断符合JPA规范。
修改后的UserEntity示例：

@Entity
data class UserEntity(
    @Id
    val id: UUID,
    val name: String,

    @ElementCollection
    val interests: Set<InterestEmbeddable> = HashSet(),

    @ElementCollection
    val badges: Set<BadgeEmbeddable> = HashSet()
) {
    @ManyToMany(mappedBy = "users")
    val groups: MutableSet<GroupEntity> = HashSet()

    override fun equals(other: Any?): Boolean {
        if (this === other) return true
        if (javaClass != other?.javaClass) return false
        other as UserEntity
        return id == other.id
    }

    override fun hashCode(): Int = id.hashCode()
}

GroupEntity也同理重写仅用id计算equals和hashCode即可，修改后HashSet的增删操作不会触发任何关联字段的查询。

方案2：直接操作连接表插入/删除数据（性能最优） #

不需要加载Group的users集合，直接通过自定义SQL操作多对多关联的连接表，全程仅执行1条SQL，性能最高。
在GroupRepository中新增自定义方法：

interface GroupRepository : JpaRepository<GroupEntity, String> {
    // 添加用户到分组
    @Modifying
    @Transactional
    @Query(nativeQuery = true, value = "INSERT INTO group_entity_users(group_entity_id, users_id) VALUES(:groupId, :userId)")
    fun addUser(groupId: String, userId: UUID)

    // 从分组移除用户
    @Modifying
    @Transactional
    @Query(nativeQuery = true, value = "DELETE FROM group_entity_users WHERE group_entity_id = :groupId AND users_id = :userId")
    fun removeUser(groupId: String, userId: UUID)
}

直接调用该方法即可完成关联操作，不需要查询Group和User实体对象。

• 不要在JPA实体上直接使用Kotlin data class的默认全属性生成规则，也不要使用Lombok的@Data注解，避免自动生成的equals/hashCode/toString方法意外触发懒加载
• 确认@ManyToMany注解的fetch策略保持默认的FetchType.LAZY，不要改为EAGER，否则会在加载Group时直接加载所有关联用户
• 若使用方案2，注意如果当前持久化上下文中已存在操作对应的Group实体，操作后需要手动调用EntityManager.refresh()刷新实体，避免上下文数据和数据库不一致

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