RediSearch：两个Tag字段的OR联合查询无法执行问题咨询

问题原因 #

你遇到的是RediSearch 2.2.5版本的语法解析限制：

• 该版本的查询解析器对OR操作符前后均为Tag类型字段的查询处理存在bug，导致@TagOne:{tag} | @TagTwo:{tag}这类语法报错；而Tag字段与其他类型字段（文本、数值等）的OR查询能正常工作，是因为解析器对不同字段类型的处理逻辑不同。
• @TagOne|TagTwo:{tag}的写法本身不符合RediSearch语法规范，每个Tag字段必须单独使用@字段名:{标签值}的格式，不支持字段名合并。

解决办法 #

1. 升级RediSearch版本（推荐） #

从RediSearch 2.4版本开始，官方修复了多Tag字段OR查询的语法解析问题，升级后你原本的命令FT.SEARCH Idx "@TagOne:{tag} | @TagTwo:{tag}"即可正常执行。

2. 不升级版本的替代方案：使用聚合查询的UNION+FILTER #

如果无法升级，可以通过FT.AGGREGATE的聚合能力来实现多Tag字段的OR匹配，示例命令如下：

FT.AGGREGATE Idx "*" LOAD 0 GROUPBY 0 REDUCE UNION 1 @TagOne @TagTwo FILTER "@TagOne == '{tag}' || @TagTwo == '{tag}'"

• LOAD 0表示不额外加载字段（如需返回文档内容，可改为LOAD *或指定字段）；
• REDUCE UNION用于合并两个Tag字段的结果；
• FILTER条件实现Tag值的精确匹配OR逻辑。

你也可以分别执行两个FT.SEARCH查询（FT.SEARCH Idx "@TagOne:{tag}"和FT.SEARCH Idx "@TagTwo:{tag}"），在应用层合并去重结果，但这种方式的效率低于聚合查询。

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