RedisSearch查询标签字段前缀时结果丢失文档的原因排查

最可能的几个原因： #

1. 词干提取（Stemming）导致索引词项变化
   RedisSearch默认对TEXT类型字段启用词干提取（基于英语词干规则），虽然viking本身的词干通常还是viking，但如果使用了非英语词干器或自定义规则，可能导致索引中存储的词干不以ing结尾，从而无法被*ing后缀匹配命中。

   • 解决：创建索引时为lemma_exact字段添加NOSTEM参数，禁用词干提取，确保索引存储原始词值：

     FT.CREATE idx ON JSON PREFIX 1 doc: SCHEMA $.lemma_exact[*] AS lemma_exact TEXT NOSTEM
     

2. 字段类型为TAG且存在匹配限制
   如果lemma_exact被定义为TAG类型，部分RedisSearch版本中，TAG字段的通配符匹配需要显式启用WILDCARD选项；或者TAG的精确匹配逻辑与TEXT不同，导致后缀通配符未命中。

   • 解决：若需保留TAG类型，创建索引时添加WILDCARD参数：

     FT.CREATE idx ON JSON PREFIX 1 doc: SCHEMA $.lemma_exact[*] AS lemma_exact TAG WILDCARD NOCASE
     

   若无需TAG的精确标签特性，可改为TEXT类型并禁用词干。

3. 大小写敏感设置冲突
   如果索引启用了CASESENSITIVE（默认不启用），而字段值的结尾ing与查询的*ing大小写不一致（比如字段值是Viking，查询用小写*ing），则无法匹配。

   • 解决：创建索引时添加NOCASE参数，忽略大小写：

     FT.CREATE idx ON JSON PREFIX 1 doc: SCHEMA $.lemma_exact[*] AS lemma_exact TEXT NOSTEM NOCASE
     

4. RedisSearch版本兼容性问题
   旧版RedisSearch（如小于2.0版本）对后缀通配符的支持存在bug，升级到最新稳定版可解决此类问题。

验证步骤 #

• 用FT.INFO idx查看索引的字段配置，确认lemma_exact的类型、是否启用词干、大小写规则等；
• 用FT.EXPLAIN idx "@lemma_exact:{*ing}"分析查询的实际匹配逻辑；
• 用FT.SEARCH idx "@lemma_exact:{viking}" LIMIT 0 0确认该词项存在于索引中。

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