go-redis FTSearch代码查询返回空结果，CLI查询正常求助

核心诱因 #

redis: Conn has unread data日志表明连接池中存在未被完整消费的Redis响应数据，这会干扰后续命令的解析，直接导致FTSearchWithArgs返回空结果，JSONSet异常也是同理。

具体排查步骤 #

• 清理未处理的命令响应：检查代码中是否存在执行Redis命令后未读取返回值的情况。比如调用Do、Send等方法后，未通过Result()或Scan()获取结果，导致响应残留。

  // 错误示例：命令执行后未处理响应
  client.Do(ctx, "HSET", "key", "field", "val")
  // 正确做法：必须处理返回结果
  _, err := client.Do(ctx, "HSET", "key", "field", "val").Result()
  if err != nil {
      // 错误处理逻辑
  }
  

• 校验连接池配置：检查连接池的ReadTimeout、MaxRetries等参数。过短的读超时可能导致命令未执行完毕就断开连接，残留未处理响应；不合理的重试机制也可能造成响应堆积。
• 对齐命令参数：对比Redis CLI使用的搜索参数与代码中FTSearchWithArgs的参数，确保索引名、查询语句、返回字段、排序规则等完全一致，避免拼写错误或格式差异。
• 排查并发操作问题：若多协程共享客户端实例，确认是否存在手动操作单个连接（如client.Conn()）的情况。手动获取的连接需保证命令串行执行，否则会出现响应错乱。
• 重置连接池：临时重启应用或调用client.Close()后重新初始化客户端，清空连接池中已有脏数据，验证问题是否消失。

JSONSet 异常额外检查 #

• 确认JSONSet的键名、JSON路径（如$根路径）、数据格式与Redis CLI执行的完全一致，避免路径错误或非法JSON数据。
• 检查JSONSet之前的命令是否存在未处理响应，残留数据会干扰当前命令的执行结果。

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