使用FT.SEARCH时Redis Search异常：更新属性后搜索结果异常

可能原因及对应排查步骤 #

1. 内存资源耗尽导致索引被淘汰 #

• 430万条JSON记录的索引会占用大量内存，若Redis实例内存接近maxmemory阈值，开启的内存淘汰策略可能会删除索引键（Redis Search的索引以特殊键形式存储）。
• 排查命令：
  • 查看内存使用情况：INFO memory，对比used_memory_human与maxmemory_human的占比。
  • 查看Redis日志，搜索是否有index deleted due to memory pressure或类似索引被删除的日志条目。

2. 索引Schema与更新路径不匹配 #

• 确认FT.CREATE时定义的字段路径与更新操作的路径完全一致。例如：
  • 若索引定义为SCHEMA $.latitude AS latitude NUMERIC $.longitude AS longitude NUMERIC $.color AS color TAG，更新时必须使用JSON.SET key $.color "new_color"，不能用其他路径（如$.details.color），否则索引无法同步更新。
• 检查索引状态：FT.INFO your_index_name，查看num_docs是否与实际存储的记录数一致，若差距过大说明索引同步异常。

3. 批量更新操作导致索引维护滞后 #

• 大规模批量更新color字段时，Redis Search的索引维护线程可能无法及时同步所有文档更新，导致索引与实际数据不一致。
• 测试方法：单条更新某条记录的color字段后，立即执行搜索，若结果正常，说明批量操作是诱因，可拆分批量任务为小批次执行，给索引维护留足时间。

4. Redis Search版本存在已知bug #

• 部分旧版本的Redis Search在处理大量文档更新时存在索引同步漏洞，导致索引失效或数据丢失。
• 解决方案：升级到Redis Stack最新稳定版（如7.2及以上版本），新版本修复了大量索引维护相关的问题。

临时恢复与验证方案 #

• 若索引已失效，可执行以下命令重建索引：
  1. 删除旧索引：FT.DROPINDEX your_index_name
  2. 重新创建索引：FT.CREATE your_index_name ON JSON PREFIX 1 "your_key_prefix:" SCHEMA $.latitude AS latitude NUMERIC $.longitude AS longitude NUMERIC $.color AS color TAG
• 重建后执行范围搜索，验证结果是否恢复正常。

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