Spring Data JPA嵌套接口投影配置问题求助

1. 正确定义嵌套投影接口 #

确保投影接口的方法名与实体字段名严格对应，嵌套投影的集合方法返回子投影接口类型：

// 模块子投影
public interface ModuleLookup {
    Long getId();
    String getName();
}

// 课程主投影
public interface CourseLookup {
    Long getId();
    String getTitle();
    String getSubTitle();
    List<ModuleLookup> getModules();
}

2. 用JPQL+别名映射实现嵌套投影 #

在Repository的查询方法中，通过层级别名将字段映射到嵌套投影的属性上，同时添加DISTINCT消除一对多关联导致的重复课程记录：

@Repository
public interface CourseRepository extends JpaRepository<CourseEntity, Long> {
    @Query("SELECT DISTINCT " +
           "c.id AS id, " +
           "c.title AS title, " +
           "c.subTitle AS subTitle, " +
           "m.id AS modules.id, " +
           "m.name AS modules.name " +
           "FROM CourseEntity c JOIN c.modules m")
    List<CourseLookup> findCoursesWithModuleDetails();
}

这里的关键是用modules.id和modules.name作为别名，对应CourseLookup中getModules()返回的ModuleLookup接口的字段，Spring Data JPA会自动将同课程的模块字段聚合为List<ModuleLookup>。

3. 用EntityGraph优化查询（推荐） #

如果觉得JPQL别名写法繁琐，可以结合@EntityGraph指定仅加载需要的字段，避免查询全量数据，同时配合投影接口自动过滤返回字段：

@Repository
public interface CourseRepository extends JpaRepository<CourseEntity, Long> {
    @EntityGraph(
        attributePaths = {"modules.id", "modules.name"},
        type = EntityGraph.EntityGraphType.FETCH
    )
    @Query("SELECT DISTINCT c FROM CourseEntity c")
    List<CourseLookup> findCoursesWithModuleDetails();
}

• attributePaths指定要加载的关联字段，只加载模块的id和name，不会查询大JSON字段；
• DISTINCT用于消除一对多关联查询产生的重复课程记录；
• 投影接口会自动只返回定义的字段，无需额外处理。

问题原因说明 #

• 之前用m.id、m.name别名导致getModules()返回null：因为Spring Data无法将扁平的查询结果映射到嵌套的List<ModuleLookup>，必须使用modules.id这种层级别名来关联主投影的modules属性；
• 直接映射m为modules查询全字段：因为没有指定要加载的模块字段，JPA默认会加载关联实体的所有字段，包括大JSON数据；
• 用DISTINCT仍有重复：一对多关联查询会生成多条结果（每个模块对应一条课程记录），需要通过DISTINCT让Spring Data将同课程的模块聚合为一个集合，同时确保投影接口的映射正确。

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