多对多关联查询User时Groups集合仅返回单个元素问题排查

1. 原生查询参数绑定错误 #

你的原生查询硬编码了gu.user_id = 3，完全未使用方法传入的userId参数，导致无论传入什么用户ID，都只会查询user_id=3的分组数据。修正后的查询如下：

@Query(value = "SELECT g.* FROM group_user gu JOIN `group` g ON gu.group_id = g.id WHERE gu.user_id = :userId;", nativeQuery = true)
Set<Group> findAllGroupsOfUser(@Param("userId") Long userId);

注意要选择g.*而非*，避免关联表冗余字段导致JPA映射出错。

2. Group实体的equals/hashCode逻辑问题 #

你使用@Data注解自动生成的equals/hashCode包含了groupMembers集合字段，当JPA加载用户分组时，集合的循环引用或未完全加载会导致多个分组被判定为重复，最终Set中仅保留一个。

解决方法：让Group仅基于主键id生成equals和hashCode：

@Builder
@Entity
@Data
@Table(name = "`group`")
@EqualsAndHashCode(of = "id") // 仅用主键判断实体相等性
public class Group extends BaseEntity {
    // 原有代码不变
}

3. User实体的groups字段被JSON忽略 #

你给groups字段添加了@JsonIgnore注解，会导致返回User对象的JSON结果中该字段被隐藏。若需返回用户分组列表，需去掉该注解，或匹配你的JsonView配置添加对应注解：

// 去掉@JsonIgnore，或替换为@JsonView(Views.Public.class)
@ManyToMany(mappedBy = "groupMembers", fetch = FetchType.LAZY, targetEntity = Group.class)
private Set<Group> groups;

4. 懒加载的事务上下文问题 #

getWithGroups方法中user.getGroups()触发懒加载，但如果方法不在事务内，会因会话关闭无法完整加载所有分组，甚至抛出LazyInitializationException。需给方法添加事务注解：

@Override
@Transactional // 确保懒加载时会话有效
public User getWithGroups(Long userId) throws ResourceNotFoundException {
    User user = this.getUserById(userId).get();
    user.getGroups(); // 触发懒加载
    return user;
}

更优方案是在UserRepository中定义fetch join查询，一次性加载用户和分组，避免懒加载问题：

@Query("SELECT u FROM User u LEFT JOIN FETCH u.groups WHERE u.id = :userId")
Optional<User> findByIdWithGroups(@Param("userId") Long userId);

之后在Service中调用该方法即可，无需手动触发懒加载。

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