如何配置Spring Boot的findAll()仅返回指定列及关联外键表的部分字段

你不需要强制使用JPQL实现该需求，根据业务场景可以选择以下几种方案，优先推荐第一种轻量无侵入的实现：

方案1：Spring Data JPA 投影（Projection） #

这是适配该需求的最优方案，无需手写自定义查询语句，仅需定义接收字段的投影接口即可：

• 定义和你预期返回字段匹配的投影接口，仅声明需要的字段的getter方法：

// 主表对应的投影
public interface PostProjection {
    Long getId();
    String getTitle();
    WriterProjection getWriter();

    // 关联writer表的子投影，仅声明需要的name字段
    interface WriterProjection {
        String getName();
    }
}

• 在Repository层直接声明返回类型为该投影的查询方法：

public interface PostRepository extends JpaRepository<Post, Long> {
    // 框架会自动映射指定字段，自动忽略多余字段和深层关联
    List<PostProjection> findAll();
}

该方案不会触发多余字段查询，也不需要修改原有实体的关联配置，性能和维护成本都最优。

方案2：懒加载+JSON序列化过滤 #

如果你的场景是直接返回实体序列化后的JSON给前端，不想修改查询逻辑，可以用该快速适配方案：

• 把不需要返回的深层关联设置为懒加载：比如Writer实体中的group字段上添加fetch = FetchType.LAZY属性
• 在不需要序列化的字段上添加@JsonIgnore注解，或者配置JSON序列化规则仅序列化非空字段，多余字段就不会出现在返回结果中。

注意：该方案需要处理好会话生命周期，否则容易触发LazyInitializationException异常，仅适合简单的小型项目使用。

方案3：JPQL构造器查询 #

如果你的字段筛选逻辑比较复杂，可以使用你提到的JPQL方案，通过SELECT NEW语法构造指定DTO对象：

@Query("SELECT new com.example.dto.PostDTO(p.id, p.title, new com.example.dto.WriterDTO(w.name)) FROM Post p JOIN p.writer w")
List<PostDTO> findAllWithSpecifiedFields();

该方案灵活度最高，但需要手写查询语句，维护成本高于投影方案。

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