Spring Boot实现按genre数组元素查询所有Book实体的方法

云原生阿岚

2026-7-17

解决方案：实现按Genre查询书籍列表

1. 修正BookEntity的Genre字段映射

JPA对原生数组类型的支持需明确数据库字段类型，以下分两种场景处理：

若使用PostgreSQL（原生支持数组）：给genre字段添加数据库类型注解

@Column(columnDefinition = "text[]")
private String[] genre;

若使用MySQL等不支持数组的数据库：将数组改为列表并添加集合注解

@ElementCollection
private List<String> genre;

2. 修正BookRepository的查询方法

原JPQL查询语法错误，提供两种可行方案：

方案一：Spring Data JPA方法名自动推导

针对数组/列表类型，Spring Data可直接通过方法名生成查询逻辑：

@Repository
public interface BookRepository extends CrudRepository<BookEntity, Long> {
    BookEntity findOneBySlug(String slug);
    
    // 查询genre数组/列表中包含指定值的书籍
    List<BookEntity> findByGenreContaining(String genre);
}

方案二：原生SQL查询（适配PostgreSQL数组）

若需更精准控制，使用原生SQL实现数组包含判断：

@Repository
public interface BookRepository extends CrudRepository<BookEntity, Long> {
    BookEntity findOneBySlug(String slug);
    
    @Query(value = "SELECT * FROM book_entity WHERE :genre = ANY(genre)", nativeQuery = true)
    List<BookEntity> findAllByGenre(@Param("genre") String genre);
}

说明：ANY(genre)会检测传入的genre值是否存在于数组的任意元素中。

3. 确认Service层代码

你的Service层逻辑无需修改，只需匹配Repository的方法名即可：

public List<Book> getAllByGenre(String genre) {
    // 对应方案一用findByGenreContaining，方案二用findAllByGenre
    List<BookEntity> books = bookRepository.findByGenreContaining(genre);
    List<Book> models = this.convertToModelsList(books);
    return models;
}