Redis FT.SYNDUMP 怎样查看词条所属的同义词组

我在排查搜索词为什么没有按预期归并时，最先需要确认的不是重新写查询，而是这个词到底属于哪个同义词组。Redis 的 FT.SYNDUMP 就是为这个检查准备的：传入索引名，它会导出该索引的同义词数据结构，帮助你从词条反查组标识和同组词条。

官方地址：https://redis.io/docs/latest/commands/ft.syndump/

最小用法是 FT.SYNDUMP index。把 index 换成实际索引名后，按返回的组标识整理词条；它查看的是同义词配置，不是执行一次搜索。

FT.SYNDUMP 只需要一个索引名

官方命令语法只有一个必需参数：索引名。它的职责是导出同义词组内容，时间复杂度为 O(1)，不需要再传入要查的词条。这个设计很适合做配置排查：先完整拿到索引里的同义词关系，再判断某个词为什么被归并或为什么没有被归并。

例如，索引叫 products 时，直接把它作为参数：

# 只读取 products 索引的同义词配置，不执行搜索
redis-cli FT.SYNDUMP products

# 将返回内容保存到临时文件，便于按组标识人工对照
redis-cli --raw FT.SYNDUMP products > syndump-products.txt

这里的 --raw 只是让 redis-cli 少一些显示层转义，方便复制和整理，不会改变服务器返回的数据。不要把导出的结果误当成商品搜索结果；它描述的是查询分析阶段可以使用的同义词关系。

返回结果怎样对应到词条所属的组

FT.SYNDUMP 返回的是同义词词条及其组标识。不同客户端可能把协议结果包装成“组标识到词条列表”的映射，也可能以列表形式展示，但判断思路不变：先找到目标词条，再读取它旁边对应的组标识，最后把同组的其他词条放在一起看。

可以用下面的伪输出理解整理方式。它只是解释字段关系，不代表某个实例的真实结果：

group-1: [golang, go语言]
group-2: [kv, key-value]
 

在这个示意中，golang 所属的组是 group-1，同组还包括 go语言。

实际 redis-cli 的行式显示和客户端 SDK 的返回类型可能不同，所以不要依赖固定的行号或缩进。程序接入时优先使用客户端对 FT.SYNDUMP 的结构化结果，再按组标识建立反向索引：词条 -> 组标识。这样定位某个词时，不需要每次重新猜测它的同义词。

先区分没有同义词、索引不存在和命令不可用

排查时最容易混淆的是“没有看到词条”和“命令没有成功”。如果索引存在但没有配置同义词，返回内容应按空数据处理；如果索引名写错，服务端会返回索引相关错误；如果当前 Redis 部署没有提供搜索命令，则会出现命令未知或模块能力不足。三种情况的处理动作不同。

# 先确认目标索引是否能被 FT.INFO 识别
redis-cli FT.INFO products

# 再读取同义词组；把错误输出保留下来，不要把它当作空结果
redis-cli FT.SYNDUMP products

# 只在确认索引存在且命令成功后，再把结果交给脚本解析
redis-cli --raw FT.SYNDUMP products | awk 'NF {print}'

上面的检查顺序把“索引存在性”和“同义词内容”分开了。awk 只用于去掉空行，不能代替对协议结构的解析；在应用程序里还应检查客户端返回的错误对象，避免把网络超时、权限问题或未知命令误判为“这个词没有同义词”。

把 FT.SYNDUMP 用在配置核对，而不是在线查询

我最后会把 FT.SYNDUMP 放在发布配置或故障排查脚本里：部署后读取一次，记录组数量与关键词条；发生查询差异时，再把目标词映射回组标识。它的价值是提供“当前索引配置是什么”的直接视图，而不是替代 FT.SEARCH 验证搜索结果。

如果同义词通过更新命令发生变化，核对动作应重新读取，而不是长期缓存旧的组关系。对不同客户端也要保留一层适配，把协议结果统一成应用自己的 map[groupID][]term 结构；这样展示格式变化不会扩散到业务代码。

FT.SYNDUMP 能按单个词条查询吗？不能把它理解成单词查询接口。它以索引为范围导出同义词数据，应用再从返回结构中定位词条。

返回空内容就是索引不存在吗？不是。空数据、索引错误和未知命令要根据命令状态与错误信息分别判断。

为什么 redis-cli 和客户端显示不一样？协议结果可能被不同客户端包装成映射或列表。应以结构化返回和组标识为判断依据，不依赖终端排版。

记住一句话：FT.SYNDUMP index 先把索引里的同义词关系导出来，再按组标识反查词条归属。把配置读取、空数据判断和搜索结果验证分开，排查会稳定很多。