Redis Search TEXT字段短横线转义失效问题求助

直接原因：搜索UUID与实际存储值不匹配 #

你的哈希映射中group字段的值是f17bffd9-49b6-11ed-ab71-e884a53f6d8a，但搜索时使用的是f17bffd8-49b6-11ed-ab71-e884a53f6d8a，两者仅第8位字符不同（9 vs 8），这是搜索结果为空的直接原因。

字段类型设计不合理 #

即使修正UUID，TEXT类型也不适合存储UUID这类需要精确匹配的字符串：

• Redis Search的TEXT字段默认会将横杠、空格等作为分词分隔符，把UUID拆分为f17bffd9、49b6等独立词段，全文搜索逻辑是匹配分词后的词段，而非整个字符串。
• 转义横杠的方式无法改变TEXT字段的分词逻辑，仅能让特定格式的字符串被视为单个词，在UUID场景下既繁琐又低效。

解决方案 #

方案1：将group改为TAG类型（推荐） #

TAG类型专为精确匹配的标签类数据设计，完美适配UUID这类唯一标识：

1. 删除原索引：

FT.DROPINDEX idx:lock

2. 重建索引，将group字段定义为TAG SORTABLE：

FT.CREATE idx:lock 
ON hash 
PREFIX 1 "lock:" 
SCHEMA 
    locked NUMERIC SORTABLE 
    resource TAG SORTABLE
    type TAG SORTABLE
    group TAG SORTABLE
    locked_at NUMERIC SORTABLE 
    locked_until NUMERIC SORTABLE

3. 使用TAG精确匹配语法查询（用{}包裹UUID）：

FT.SEARCH idx:lock "@group:{f17bffd9-49b6-11ed-ab71-e884a53f6d8a}"

方案2：保留TEXT类型，使用短语精确匹配 #

如果必须保留TEXT类型，可通过双引号包裹UUID实现短语精确匹配：

FT.SEARCH idx:lock "@group:\"f17bffd9-49b6-11ed-ab71-e884a53f6d8a\""

注意：在redis-cli中需要转义双引号，因此输入时要写成\"。这种方式查询效率远低于TAG类型，不推荐用于UUID场景。

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