Spring Data + Hibernate @JoinTable 异常行为问题求助

问题场景 #

基于JPA搭建安全控制体系，涉及三个核心实体：

• UserAccount：通过securityGroups关联用户所属安全组
• SecurityGroup：通过securityPermissionCollection关联组内权限
• SecurityPermission：存储具体权限定义

测试用户分配了3个安全组，每个组权限数量不同，但实际查询时UserAccount的securityGroups集合返回243条数据（所有组的权限总数），每个安全组重复出现的次数等于其拥有的权限数，与预期的3个组对象不符。

问题原因 #

JPA加载EAGER类型的多对多关联时，会执行左连接查询，导致SecurityGroup与SecurityPermission产生笛卡尔积，同一个安全组会因对应多条权限数据而被重复加载到集合中。此外，UserAccount关联配置中的unique=true属性配置错误，限制了安全组的多用户关联。

修复方案 #

1. 使用Set替代Collection存储关联集合 #

利用Set的自动去重特性，避免重复对象：
修改UserAccount实体：

@Entity
@Table(name = "user_account")
public class UserAccount implements Serializable {
    @Id
    @Basic(optional = false)
    @Column(name = "UUID")
    private String uuid;
    @Basic(optional = false)
    @Column(name = "username")
    private String username;

    @JoinTable(name = "user_security_group", 
               joinColumns = @JoinColumn(name = "USER_UUID"),
               inverseJoinColumns = @JoinColumn(name = "security_group_uuid"))
    @ManyToMany(fetch = FetchType.EAGER)
    private Set<SecurityGroup> securityGroups;
    
    // Getters and setters omitted for brevity
}

修改SecurityGroup实体：

@Entity
@Table(name = "security_group")
public class SecurityGroup implements Serializable {

    private static final long serialVersionUID = 1L;
    @Id
    @Basic(optional = false)
    @Column(name = "UUID")
    private String uuid;
    @Basic(optional = false)
    @Column(name = "GROUP_ID")
    private String groupId;
    @Basic(optional = false)
    @Column(name = "description")
    private String description;

    @JoinTable(name = "security_group_permissions", joinColumns = {
        @JoinColumn(name = "GROUP_ID", referencedColumnName = "GROUP_ID")}, inverseJoinColumns = {
        @JoinColumn(name = "permission_id", referencedColumnName = "PERMISSION_ID")})
    @ManyToMany(fetch = FetchType.EAGER)
    private Set<SecurityPermission> securityPermissionCollection;
    
    // Getters and setters omitted for brevity
}

2. 查询时添加DISTINCT关键字（保留Collection的方案） #

如果需要继续使用Collection，可以在Repository查询中添加DISTINCT去重：

import org.springframework.data.jpa.repository.Query;
import org.springframework.data.repository.CrudRepository;
import org.springframework.data.repository.query.Param;

public interface UserAccountRepository extends CrudRepository<UserAccount, String> {
    @Query("SELECT DISTINCT u FROM UserAccount u JOIN FETCH u.securityGroups g JOIN FETCH g.securityPermissionCollection WHERE u.uuid = :uuid")
    UserAccount findDistinctByUuid(@Param("uuid") String uuid);
}

3. 调整加载策略（可选） #

将fetch = FetchType.EAGER改为FetchType.LAZY，延迟加载权限集合，避免一次性查询产生笛卡尔积。注意需在事务范围内访问懒加载集合，否则会抛出LazyInitializationException。

关键错误修正 #

移除UserAccount中@JoinTable的unique=true属性：原配置中inverseJoinColumns = @JoinColumn(name = "security_group_uuid", unique = true)会导致每个安全组只能被一个用户关联，违反多用户多组的业务逻辑，必须删除该属性。

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