Spring Data JPA根据分类列表查询匹配任意分类图书的问题排查

原代码无法运行主要有3个核心问题：

• 主键泛型不匹配：Book实体主键类型为String，但JpaRepository泛型声明的主键类型是Integer，会直接导致上下文启动失败。
• 关联配置缺失：@OneToMany注解未配置关联映射规则，JPA默认会生成多余的Book-Category中间表，和实际表结构不匹配。
• 查询结果重复：直接join查询时，如果同一本书匹配多个传入的分类，会返回多条重复的Book记录，导致分页结果不准、总条数计算错误。
• 命名歧义：Book中存储分类集合的字段名category为单数，和Category类名重名，容易引发映射逻辑混乱。

实体类修正 #

@Entity
@Table(name = "Book")
@Data
public class Book {
    @Id
    private String id;
    // 配置关联外键，字段名改为复数形式更贴合集合语义
    @OneToMany
    @JoinColumn(name = "book_id") // 对应Category表中关联Book的外键字段，可根据实际表结构调整字段名
    private List<Category> categories;
}

@Entity
@Table(name="Category")
@Data
public class Category {
    @Id
    private int id;    
    private String category;
}

Repository层修正 #

@Repository
// 修正JpaRepository主键泛型为String，和Book主键类型一致
public interface BookDao extends JpaRepository<Book, String> {
    
    // 加distinct去重，单独指定countQuery保证分页总条数计算正确
    @Query(
        value = "SELECT distinct b FROM Book b join b.categories c where c.category in :category",
        countQuery = "SELECT count(distinct b) FROM Book b join b.categories c where c.category in :category"
    )
    Page<Book> getBooksByCat(@Param("category") List<String> category, Pageable pageable);
}

如果需要从Category反向查询所属Book，可以配置双向关联，避免使用中间表：

1. 在Category实体中添加多方关联配置：

@ManyToOne
@JoinColumn(name = "book_id")
private Book book;

2. 修改Book实体的@OneToMany注解：

@OneToMany(mappedBy = "book")
private List<Category> categories;

配置后不需要额外指定@JoinColumn，JPA会自动按外键关联查询。

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