JPA查询角色组关联角色时如何避免获取权限等额外数据？

当前使用@EntityGraph加载RoleGroup的roles关联时，会意外触发Role的privileges等关联数据的查询（可能是DTO转换时懒加载被触发，或JPA默认行为导致）。需求是仅获取RoleGroup的id、name，以及关联Role的id、name，不加载其他无关数据。

以下是几种可行的解决方案：

方案1：使用Spring Data JPA接口投影 #

定义投影接口明确指定需要返回的字段，JPA会自动生成仅查询这些字段的SQL，完全避免加载不必要的关联或字段。

首先定义Role的投影接口：

public interface RoleProjection {
    Long getId();
    String getName();
}

接着定义RoleGroup的投影接口，包含Role的投影集合：

public interface RoleGroupWithRolesProjection {
    Long getId();
    String getName();
    Set<RoleProjection> getRoles();
}

修改Repository接口，使用投影返回结果：

public interface RoleGroupRepository extends JpaRepository<RoleGroup, Long> {
    List<RoleGroupWithRolesProjection> findAllProjectedBy();
}

这种方式只会查询role_group表的id、name，以及关联的role表的id、name，不会涉及privilege或其他关联表，性能最优。

方案2：自定义JPQL直接构造DTO #

通过编写JPQL明确指定要查询的字段，直接在查询中构造目标DTO对象，无需后续转换，且完全避免加载无关数据。

在Repository中添加自定义查询：

public interface RoleGroupRepository extends JpaRepository<RoleGroup, Long> {
    @Query("SELECT new com.yourpackage.dto.RoleGroupWithRolesDto(rg.id, rg.name, " +
           "CAST(COLLECT(new com.yourpackage.dto.RoleDto(r.id, r.name)) AS java.util.List)) " +
           "FROM RoleGroup rg LEFT JOIN rg.roles r " +
           "GROUP BY rg.id, rg.name")
    List<RoleGroupWithRolesDto> findAllRoleGroupsWithRoles();
}

注意替换com.yourpackage.dto为你实际的DTO包路径。如果部分角色组没有关联角色，LEFT JOIN会保证这些角色组仍被返回，对应的roles列表为空。

方案3：精确控制EntityGraph加载范围 #

如果坚持使用EntityGraph，可以通过命名实体图精确指定要加载的属性，避免初始化Role的其他关联。

首先在RoleGroup实体上定义命名EntityGraph：

@Entity
@NamedEntityGraph(
    name = "RoleGroup.roles-basic",
    attributeNodes = {
        @NamedAttributeNode(value = "roles", subgraph = "Role.basic")
    },
    subgraphs = {
        @NamedSubgraph(
            name = "Role.basic",
            attributeNodes = { @NamedAttributeNode("id"), @NamedAttributeNode("name") }
        )
    }
)
public class RoleGroup {
    // ... 原有实体代码
}

然后在Repository中使用该命名EntityGraph：

public interface RoleGroupRepository extends JpaRepository<RoleGroup, Long> {
    @EntityGraph(value = "RoleGroup.roles-basic", type = EntityGraph.EntityGraphType.FETCH)
    List<RoleGroup> findAll();
}

这种方式会加载RoleGroup的roles关联，但仅初始化Role的id和name字段，privileges等关联仍保持懒加载状态。注意：转换DTO时必须严格只访问Role的id和name，否则仍会触发懒加载查询。

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