Redis FT.SEARCH 怎样按字段条件搜索文档

Redis FT.SEARCH 按字段条件搜索文档，关键不在于把所有条件都拼进一串字符串，而在于先确认字段在索引里声明成了什么类型。分类字段用 @category:{book}，数值字段用 @price:[100 500]，标题等文本字段才使用全文搜索表达式。字段类型对不上时，命令可能执行成功，却返回空结果或范围不符合预期。

一、先把字段类型和查询语法对上

假设 Hash 文档使用 product: 前缀，索引里有分类、价格和标题三个字段：

# 分类是短值，价格是数值，标题保留全文检索能力
FT.CREATE idx:product ON HASH PREFIX 1 product: SCHEMA category TAG price NUMERIC title TEXT

# 写入一条可被索引的 Hash 文档
HSET product:100 category book price 168 title "Redis Search 入门"

# 按分类精确匹配，并筛出价格区间
FT.SEARCH idx:product "@category:{book} @price:[100 500]" LIMIT 0 20

TAG 的查询值写在花括号里，适合 book、new、east 这类离散值；NUMERIC 的方括号表示范围，[100 500] 是包含两端的区间。Redis 官方文档还给出了 FILTER price 100 500 的写法，但把条件放在查询表达式里更容易和其他字段一起阅读。

二、让 FT.SEARCH 同时处理文本、标签和数值条件

字段条件可以组合使用。查询串中的空格通常表示同时满足；同一字段的多个标签值可以用竖线表达 OR。文本字段则遵循全文搜索语法，不能把短分类值直接当成全文字段处理。

# 同时要求分类为 book、价格不超过 500，标题包含 Redis
FT.SEARCH idx:product "@category:{book} @price:[-inf 500] @title:Redis" DIALECT 2

# 分类允许 book 或 magazine，价格大于等于 100
FT.SEARCH idx:product "@category:{book|magazine} @price:[100 +inf]" DIALECT 2

如果标签值里包含空格或特殊字符，先按 Redis Search 的转义规则处理，再配合 DIALECT 2 验证复杂写法。这里的边界是“字段已被正确索引”：FT.SEARCH 只会在索引声明覆盖的字段中检索，不会因为 Hash 里后来增加了一个字段就自动把它当成可搜索字段。

三、控制返回字段和分页结果

命中条件后，默认结果可能带回完整文档。接口只需要列表字段时，可以用 RETURN 做投影，再用 SORTBY 和 LIMIT 固定分页边界：

# 只返回文档键、标题和价格，按价格升序取第一页
FT.SEARCH idx:product "@category:{book}" RETURN 3 __key title price SORTBY price ASC LIMIT 0 20 DIALECT 2

返回结果的第一项是命中总数，后面才是文档内容；它不等于本页返回条数。分页查询如果需要稳定顺序，应明确指定排序字段，并保证这个字段已按 SORTABLE 方式加入 schema，否则不要把返回顺序当成业务排序。

四、空结果时按四个证据排查

第一，检查 FT.INFO idx:product，确认字段名称和类型确实存在；第二，确认写入的键匹配索引的 prefix；第三，把复杂条件缩成 * 或单字段条件，判断是哪一项过滤掉了结果；第四，遇到特殊字符、精确匹配或新语法时显式带上合适的 DIALECT。不要先盲目扩大价格范围，因为空结果也可能来自字段名拼错或文档根本没有进入索引。

相关问题

TAG 字段能不能直接写成普通单词？

不建议。精确标签查询应使用花括号，例如 @category:{book}；普通单词会按文本查询语义解释。

怎样查询数值字段的单点值？

可用相同的上下界，如 @price:[168 168]；支持对应方言时也可使用等值语法，但上线前要按目标 Redis Search 版本复查。

为什么 LIMIT 取 20 但总数更大？

LIMIT 只控制本页返回数量，结果头部的总数仍表示整个查询命中的文档数。