Spring Data JPA双向多对多映射：用户端无法加载关联组问题

问题分析 #

你遇到的核心问题是：双向多对多映射中，作为关系拥有方的User查询后groups集合为空，但反向端Group查询后users集合正常。原因主要有两点：

1. 默认懒加载未触发：JPA中@ManyToMany默认使用FetchType.LAZY（懒加载），Spring Data JPA的Example查询不会自动关联抓取关联集合，导致查询User后，groups是未初始化的代理集合，表现为空。
2. 查询未显式关联加载：Example查询无法添加关联抓取逻辑，必须通过自定义查询指定FETCH JOIN才能加载关联的groups集合。

解决方案 #

方案1：自定义查询实现关联抓取（推荐） #

在UserRepository中添加带FETCH JOIN的自定义查询方法，强制加载groups集合：

import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.Query;
import org.springframework.data.repository.query.Param;
import java.util.Optional;
import java.util.UUID;

public interface UserRepository extends JpaRepository<User, UUID> {
    // 根据邮箱查询并关联加载groups
    @Query("SELECT u FROM User u LEFT JOIN FETCH u.groups WHERE u.email = :email")
    Optional<User> findByEmailWithGroups(@Param("email") String email);
}

替换测试代码中的Example查询：

Optional<User> userOpt = users.findByEmailWithGroups(exampleUser.getEmail());
User inDB = userOpt.orElseGet(() -> {
    // 创建新用户逻辑
    User newUser = new User();
    newUser.setEmail(userInfo.getEmail());
    newUser.setName(userInfo.getPreferred_username());
    newUser.setCredentialSourceType(CredentialSourceType.SSO);
    newUser.setSsoprovider(provider);
    // 设置组时维护双向关系
    Set<Group> targetGroups = resolved.isClient_only() ? groups.getClientGroup()
            : userInfo.getGroups().contains("admin") ? groups.getAdminGroup() : groups.getStaffGroup(userInfo.getGroups());
    newUser.setGroups(targetGroups);
    newUser.setSSO_Credentials(Set.of(new SSOCredentialsStore[0]));
    return users.save(newUser);
});

// 此时inDB的groups集合已正常加载
Set<Group> uGps = inDB.getGroups();

方案2：维护双向关系的内存一致性（辅助） #

为避免内存中对象关系不一致，在User类中添加维护双向关系的方法，确保设置groups时同步更新Group的users集合：

@Data
@Entity
@Table(name = "app_user")
public class User {
    // 其他字段...

    @ManyToMany(cascade = {CascadeType.PERSIST, CascadeType.MERGE}, targetEntity = Group.class)
    @JoinTable(
        name = "app_user_to_user_group",
        joinColumns = @JoinColumn(name="app_user_id"),
        inverseJoinColumns = @JoinColumn(name="user_group_name")
    )
    private Set<Group> groups = new HashSet<>();

    // 添加维护双向关系的方法
    public void addGroup(Group group) {
        this.groups.add(group);
        group.getUsers().add(this);
    }

    public void removeGroup(Group group) {
        this.groups.remove(group);
        group.getUsers().remove(this);
    }

    // 重写setGroups方法，批量设置时同步维护反向关系
    public void setGroups(Set<Group> groups) {
        this.groups.clear();
        groups.forEach(this::addGroup);
    }
}

方案3：修改为立即加载（不推荐） #

将User的@ManyToMany注解改为FetchType.EAGER，强制每次查询User时自动加载groups集合。此方式会降低查询性能，仅适合确定每次都需要加载groups的场景：

@ManyToMany(cascade = {CascadeType.PERSIST, CascadeType.MERGE}, targetEntity = Group.class, fetch = FetchType.EAGER)
@JoinTable(
    name = "app_user_to_user_group",
    joinColumns = @JoinColumn(name="app_user_id"),
    inverseJoinColumns = @JoinColumn(name="user_group_name")
)
private Set<Group> groups = new HashSet<>();

关键说明 #

• JPA仅同步关系拥有方（User）的变更到数据库，但反向端（Group）的内存集合需手动维护，否则会出现内存对象与数据库数据不一致的情况。
• Example查询无法支持关联抓取，复杂查询建议使用自定义@Query实现。

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