Node.js中使用RedisJSON存储JSON数组及查询问题排查

问题 #

希望通过RedisJSON存储对象数组并实现嵌套属性查询，现有数据结构如下：

const data = [
  {
    _id: '63e7d1d85ad7e2f69df8ed6e',
    artist: {
      genre: 'rock',
    },
  },
  {
    _id: '63e7d1d85ad7e2f69df8ed6f',
    artist: {
      genre: 'metal',
    },
  },
  {
    _id: '63e7d1d85ad7e2f69df8ed6g',
    artist: {
      genre: 'rock',
    },
  },
]

已通过以下代码完成存储与读取：

await redisClient.json.set(cacheKey, '$', data)
await redisClient.json.get(cacheKey)

但创建索引后查询不符合预期，索引创建代码：

await redisClient.ft.create(
  `idx:gigs`,
  {
    '$.[0].artist.genre': {
      type: SchemaFieldTypes.TEXT,
      AS: 'genre',
    },
  },
  {
    ON: 'JSON',
    PREFIX: 'GIGS',
  }
)

执行查询：

const searchResult = await redisClient.ft.search(`idx:gigs`, '@genre:(rock)')

返回结果为整个数组而非符合genre: rock的2个对象：

{
    total: 1,
    documents: [
        { id: 'cacheKey', value: [Array] }
    ]
}

问题原因 #

1. 索引路径错误：使用$.[0].artist.genre作为索引路径，只会索引数组第一个元素的genre值，而非数组中所有元素的该属性。
2. 文档粒度问题：将整个数组作为单个RedisJSON文档存储，RediSearch的查询粒度是文档级，匹配时会返回整个数组文档，而非数组内的单个元素。

解决方案 #

方案一：将数组元素拆分为独立RedisJSON文档（推荐） #

把每个对象作为单独的Redis键存储，查询时可精准返回符合条件的单个对象，更贴合常规查询需求。

存储代码

// 遍历数组，为每个元素创建独立的JSON文档
for (const item of data) {
  // 用_id作为键的后缀，保证唯一性
  await redisClient.json.set(`GIGS:${item._id}`, '$', item);
}

创建索引

await redisClient.ft.create(
  `idx:gigs`,
  {
    // 索引所有文档的artist.genre属性
    '$.artist.genre': {
      type: SchemaFieldTypes.TEXT,
      AS: 'genre',
    },
    // 可选：索引_id字段，方便后续精准查询
    '$.id': {
      type: SchemaFieldTypes.TAG,
      AS: 'docId',
    }
  },
  {
    ON: 'JSON',
    // 匹配所有以GIGS:开头的键
    PREFIX: 'GIGS:',
  }
);

查询代码

const searchResult = await redisClient.ft.search(`idx:gigs`, '@genre:(rock)');
// 返回结果中的documents会包含2个符合条件的独立对象

方案二：保留数组结构，使用多值索引 #

若必须保留数组作为单个文档存储，可通过多值索引实现查询，再在客户端提取符合条件的元素。

创建多值索引

await redisClient.ft.create(
  `idx:gigs`,
  {
    // 用$[*]匹配数组所有元素，MULTI启用多值索引
    '$[*].artist.genre': {
      type: SchemaFieldTypes.TEXT,
      AS: 'genre',
      MULTI: true,
    },
  },
  {
    ON: 'JSON',
    PREFIX: 'GIGS',
  }
);

查询并提取匹配元素

通过RETURN参数指定JSONPath过滤条件，直接返回数组中符合要求的元素：

const searchResult = await redisClient.ft.search(
  `idx:gigs`,
  '@genre:(rock)',
  {
    // 提取数组中genre等于rock的元素
    RETURN: ['$[*]?(exists(@.artist.genre) && @.artist.genre=="rock")']
  }
);

返回结果会包含匹配的元素集合，需在客户端做简单解析。

结论 #

完全可以通过RedisJSON存储对象数组并查询嵌套对象的属性值，核心要点：

• 选择合适的文档结构（单元素文档或数组文档）
• 正确编写索引路径（用$[*]匹配数组所有元素，而非指定下标$.[0]）

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