Redis集群环境下FT.SEARCH查询无结果问题求助

1. 确认索引与数据的哈希槽一致性 #

Redis集群分片存储时，RediSearch要求索引键和被索引的数据键必须落在同一个哈希槽，否则索引无法同步数据变化。

• 执行以下命令分别获取数据键和索引键的哈希槽：

  CLUSTER KEYSLOT book:HFDP-1
  CLUSTER KEYSLOT bookdata-idx
  

• 若两个结果不一致，需修改键名使用哈希标签强制同槽，比如将索引命名为{book}:idx，数据键命名为{book}:HFDP-1，确保{}包裹的部分相同。

2. 验证索引字段映射与配置 #

• 查看索引详细定义，确认字段映射的JSON路径正确：

  FT.INFO bookdata-idx
  

  检查fields列表中BOOKID对应的path是否匹配实际JSON结构（比如是否为$.bookId），路径错误会导致索引无法提取字段值。
• TEXT类型字段默认会分词，若需精确匹配，创建索引时需添加NOSTEM参数，或查询时使用精确匹配语法：

  FT.SEARCH bookdata-idx @BOOKID:"HFDP-1"
  

3. 检查RedisJSON数据完整性 #

• 直接读取数据键，验证存储的JSON结构和字段值是否正确：

  JSON.GET book:HFDP-1
  

  确认BOOKID字段值为"HFDP-1"，无拼写、大小写或类型错误（比如是否误存为数值类型）。

4. 确认索引的键前缀配置 #

• 通过FT.INFO bookdata-idx查看prefixes字段，确认索引关联的前缀是book:，若前缀拼写错误（比如少冒号、拼写偏差），索引不会包含目标数据键。

5. 修正查询语法 #

• 你使用的@BOOKID:HFDP*1模糊匹配不符合RediSearch规则，*需放在匹配段的开头或结尾：
  • 匹配以HFDP开头的BOOKID：@BOOKID:HFDP*
  • 匹配以1结尾的BOOKID：@BOOKID:*1
  • 精确匹配优先测试：FT.SEARCH bookdata-idx @BOOKID:"HFDP-1"

6. 排查版本兼容性问题 #

• 你使用的RedisJSON版本99.99.99为非官方稳定版本，可能与RediSearch v2.4.15存在兼容性问题。建议替换为与RediSearch同系列的官方稳定版RedisJSON（如v2.4.0），避免因版本不兼容导致索引失效。

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