使用Interface Projection查询列表结果时数据不符问题

问题根源 #

1. 自定义JPQL查询逻辑问题：你的查询是Author与Book的关联查询，返回的是每一条Author+Book的组合记录，所以会出现多个重复的Author条目；同时查询结果没有映射到投影的books集合字段，导致books为null。
2. 投影方法与查询别名不匹配：投影接口BookProjection的方法是getBookTitle()、getBookPages()，但查询里的别名是title、pages，两者无法对应。
3. 返回结构不符预期：控制器返回List类型，但你期望的是单个带书籍集合的Author对象。
4. 实体缺少无参构造：Hibernate实例化实体需要无参构造，而你只加了@AllArgsConstructor，可能导致加载异常。

解决方案（推荐方案：实体查询+DTO转换） #

这种方法逻辑清晰，避免投影映射的复杂问题，同时保证返回结构符合预期。

1. 修复实体类，添加无参构造

给Author和Book实体添加@NoArgsConstructor：

// Author实体
@Getter
@Setter
@AllArgsConstructor
@NoArgsConstructor // 新增
@Entity
public class Author {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    private String name;

    @OneToMany(mappedBy = "author", cascade = CascadeType.ALL)
    private List<Book> books;
}

// Book实体
@Getter
@Setter
@AllArgsConstructor
@NoArgsConstructor // 新增
@Entity
public class Book {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    private String title;
    private int pages;

    @ManyToOne
    @JoinColumn(name ="author_id")
    private Author author;
}

2. 修改Repository，使用Fetch Join查询关联数据

用JOIN FETCH一次性加载Author和关联的Books，避免N+1查询问题：

@Repository
public interface AuthorRepository extends JpaRepository<Author, Long> {
    @Query("SELECT a FROM Author a JOIN FETCH a.books WHERE a.id = :idUser")
    Optional<Author> findAuthorWithBooks(@Param("idUser") Long id);
}

3. 创建DTO类，转换为期望的返回结构

定义DTO类来封装需要返回的数据：

public class AuthorWithBooksDTO {
    private Long authorId;
    private String authorName;
    private List<BookDTO> books;

    public AuthorWithBooksDTO(Author author) {
        this.authorId = author.getId();
        this.authorName = author.getName();
        this.books = author.getBooks().stream()
                .map(book -> new BookDTO(book.getTitle(), book.getPages()))
                .collect(Collectors.toList());
    }

    // 内部类封装书籍信息
    public static class BookDTO {
        private String title;
        private int pages;

        public BookDTO(String title, int pages) {
            this.title = title;
            this.pages = pages;
        }

        // Getter方法
        public String getTitle() { return title; }
        public int getPages() { return pages; }
    }

    // Getter方法
    public Long getAuthorId() { return authorId; }
    public String getAuthorName() { return authorName; }
    public List<BookDTO> getBooks() { return books; }
}

4. 修改Service，返回DTO对象

@Service
public class AuthorService {
    private final AuthorRepository authorRepository;

    @Autowired
    public AuthorService(AuthorRepository authorRepository) {
        this.authorRepository = authorRepository;
    }

    public AuthorWithBooksDTO getAuthorWithBooks(Long idUser) {
        return authorRepository.findAuthorWithBooks(idUser)
                .map(AuthorWithBooksDTO::new)
                .orElseThrow(() -> new RuntimeException("未找到ID为" + idUser + "的作者"));
    }
}

5. 修改Controller，返回单个DTO

@RestController
@RequestMapping("/authors")
public class AuthorController {
    private final AuthorService authorService;

    @Autowired
    public AuthorController(AuthorService authorService) {
        this.authorService = authorService;
    }

    @GetMapping("/withBooks/{id}")
    public AuthorWithBooksDTO getAuthorWithBooks(@PathVariable(name = "id") Long idUser) {
        return authorService.getAuthorWithBooks(idUser);
    }
}

另一种方案：修复投影映射（适合简单场景） #

如果坚持用投影，需要调整查询和投影接口的匹配关系：

1. 修改投影接口方法名，与查询别名对应：

public interface AuthorWithBooksProjection {
    Long getAuthorId();
    String getAuthorName();
    List<BookProjection> getBooks();
}

interface BookProjection {
    String getTitle(); // 对应查询的title别名
    int getPages();    // 对应查询的pages别名
}

2. 但Spring Data投影无法自动将多行查询结果合并为单个带集合的对象，所以仍需在Service层手动合并数据，复杂度较高，不如DTO转换方案直观。

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