Spring Data JPA中多对多关联表的指定列查询问题

你遇到的问题确实很典型——JPQL的构造器语法没办法直接处理嵌套集合类型的DTO，而直接查询完整实体再映射又显得冗余。下面给你几个更优雅的方案，适配Spring Boot 2.3 + Spring Data JPA的环境：

方案1：Spring Data Interface Projections（最推荐） #

Spring Data JPA的接口投影是处理这类需求最简洁的方式，它会自动帮你聚合关联的集合数据，不需要手动处理结果映射。

首先定义投影接口：

// 桌游投影，包含关联的出版社和分类
public interface BoardgameProjection {
    Long getId();
    String getName();
    // 映射实体中publisher的name属性
    String getPublisherName();
    // 分类集合投影
    Set<CategoryProjection> getCategories();

    // 分类子投影接口
    interface CategoryProjection {
        String getName();
        String getShortDesc();
    }
}

然后在你的BoardgameRepository里添加查询方法：

public interface BoardgameRepository extends JpaRepository<Boardgame, Long> {
    // 按ID查询指定字段，自动返回投影对象
    BoardgameProjection findProjectedById(Long id);
}

Spring Data会自动解析这个方法，生成对应的查询语句，只获取你需要的字段，并且正确聚合分类集合。全程不需要写JPQL或SQL，框架会帮你处理所有细节。

方案2：自定义JPQL + 服务层结果聚合（适合复杂查询场景） #

如果你需要更灵活的自定义查询逻辑，可以先通过JPQL查询出扁平化的结果，再在服务层手动将多行数据聚合成带集合的DTO：

首先在Repository里定义返回Tuple的查询：

public interface BoardgameRepository extends JpaRepository<Boardgame, Long> {
    @Query("""
            SELECT bg.id, bg.name, p.name as publisherName, c.name as categoryName, c.shortDesc as categoryShortDesc
            FROM Boardgame bg
            JOIN bg.publisher p
            JOIN bg.categories c
            WHERE bg.id = :id
            """)
    List<Tuple> findBoardgameDetailsById(Long id);
}

然后在服务层处理结果聚合：

public BoardgameDto getBoardgameDetails(Long id) {
    List<Tuple> tuples = boardgameRepository.findBoardgameDetailsById(id);
    if (tuples.isEmpty()) {
        throw new RuntimeException("Boardgame not found");
    }
    // 初始化桌游DTO
    Tuple firstTuple = tuples.get(0);
    BoardgameDto dto = new BoardgameDto();
    dto.setId((Long) firstTuple.get("id"));
    dto.setName((String) firstTuple.get("name"));
    dto.setPublisherName((String) firstTuple.get("publisherName"));
    // 聚合分类数据到集合
    Set<CategoryDto> categories = tuples.stream()
            .map(t -> {
                CategoryDto catDto = new CategoryDto();
                catDto.setName((String) t.get("categoryName"));
                catDto.setShortDesc((String) t.get("categoryShortDesc"));
                return catDto;
            })
            .collect(Collectors.toSet());
    dto.setCategoryDto(categories);
    return dto;
}

这种方式比直接查询完整实体更高效，因为只查询你需要的字段，同时能灵活控制查询逻辑。

方案3：原生SQL + 结果映射（适配原生SQL场景） #

如果你想沿用已写好的原生SQL，可以用@SqlResultSetMapping来映射结果，但要注意：原生SQL的结果映射处理集合比较繁琐，更适合扁平化结果，这里给出简化版思路：

@Entity
@SqlResultSetMapping(
        name = "BoardgameFlatMapping",
        classes = @ConstructorResult(
                targetClass = BoardgameFlatDto.class, // 先定义扁平化DTO
                columns = {
                        @ColumnResult(name = "id", type = Long.class),
                        @ColumnResult(name = "name"),
                        @ColumnResult(name = "publisherName"),
                        @ColumnResult(name = "categoryName"),
                        @ColumnResult(name = "categoryShortDesc")
                }
        )
)
public class Boardgame {
    // 实体原有代码...
}

之后在Repository里调用原生SQL：

public interface BoardgameRepository extends JpaRepository<Boardgame, Long> {
    @Query(value = """
            SELECT bg.id, bg.name, p.name as publisherName, c.name as categoryName, c.short_desc as categoryShortDesc 
            FROM boardgame as bg 
            JOIN boardgame_category bgc on bg.id = bgc.fk_game 
            JOIN publisher p on bg.fk_publisher = p.id 
            JOIN category c on bgc.fk_category = c.id 
            WHERE bg.id = :id
            """, nativeQuery = true, resultSetMapping = "BoardgameFlatMapping")
    List<BoardgameFlatDto> findBoardgameFlatDetailsById(Long id);
}

最后还是需要在服务层把扁平化的结果聚合成带集合的BoardgameDto，所以这个方案不如前两个简洁。

为什么你之前的JPQL写法不行？ #

你说得完全正确：JPQL的构造器语法不支持嵌套构造器生成集合——它只能为每行查询结果生成一个独立的DTO对象，没办法自动把多行结果里的分类数据聚合到单个BoardgameDto的集合属性中，这就是IDE报错的核心原因。

对比你当前的方案 #

你现在用findById()查询完整实体再映射的方式，会加载实体的所有字段（包括不需要的），而且如果多对多关联是懒加载的话，还可能触发N+1查询问题（访问categories时会额外查询分类表）。前面的方案都能避免这些问题，只查询你需要的字段，性能更优。

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