JpaRepository如何查询标签列包含指定数组所有标签的分页数据

直接用PostgreSQL原生数组能力实现，既可以避免传统多LIKE拼接带来的子串误匹配问题，写法也更简洁，适配Spring Data JPA分页场景。

正确的Repository写法 #

直接替换@Query注解内容即可，注意原生查询需要指定nativeQuery = true，同时分页场景必须配套编写总条数统计的countSQL：

@Query(
    value = "SELECT * FROM challenge WHERE string_to_array(tags, ',') @> CAST(:tags AS text[])",
    countQuery = "SELECT COUNT(*) FROM challenge WHERE string_to_array(tags, ',') @> CAST(:tags AS text[])",
    nativeQuery = true
)
Page<Challenge> findByTags(String[] tags, Pageable pageable);

语法说明 #

• string_to_array(tags, ',')：将表中存储的逗号分隔字符串格式的tags，按逗号切分为PostgreSQL原生text数组，切分后每个元素是独立的完整标签，不会出现模糊匹配时搜"sp"命中"spring"的误判问题
• @>：PostgreSQL专属的数组包含操作符，语义为「左侧数组包含右侧数组的全部元素」，完全匹配“必须包含传入所有标签”的筛选要求
• CAST(:tags AS text[])：将Java层传入的String[]类型参数显式转换为PostgreSQL的text数组，解决JPA参数绑定时的类型不匹配问题
• 单独声明countQuery：原生SQL实现分页时必须指定对应count查询，否则JPA无法自动计算总页数、总条数，会抛出分页查询异常

可选优化 #

如果数据量较大，可以给表加一个基于tags拆分后数组的表达式索引，查询性能会比多个LIKE拼接的方案高一个量级：

CREATE INDEX idx_challenge_tags_arr ON challenge USING GIN (string_to_array(tags, ','));

注意：不要使用LIKE '%tag%'拼接多个条件的方案，除了子串误匹配问题外，标签数量变化时需要动态拼接SQL，维护成本很高，性能也更差。

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