如何让Redis FT.SEARCH返回正确类型？数组仅返回首元素问题

问题出在FT.SEARCH的RETURN子句未正确指定JSON数组路径，以及结果未做类型解析。以下是具体修复步骤：

1. 修改FT.SEARCH查询，使用JSON路径获取完整数组 #

Redis OM将数据存储为JSON文档，要获取完整数组，需在RETURN子句中使用JSON路径语法$.字段名，并通过AS别名保持字段名称不变。

修改代码中构建查询的部分：

// 构造RETURN子句的字段参数（针对数组字段使用JSON路径）
const returnFields = [];
fieldsData.forEach(f => {
  if (f.type === 'array') {
    // 数组字段使用JSON路径，并别名回原字段名
    returnFields.push(`$.${f.field}`, `AS ${f.field}`);
  } else {
    returnFields.push(f.field);
  }
});

// 构建完整查询
const RAW_QUERY = ['FT.SEARCH', INDEX_NAME, QUERY_FILTER, 'RETURN', String(fieldsData.length), ...returnFields, 'LIMIT', '0', '10000'];

2. 解析结果中的数组和数字类型 #

FT.SEARCH返回的所有值都是字符串，需手动将数组的JSON字符串解析为JS数组，将数字字符串转为数字：

// 处理查询结果，转换为正确类型
const processedResults = [];
if (SEARCH_RESULTS[0] > 0) {
  // 跳过第一个元素（结果总数），遍历每个实体
  for (let i = 1; i < SEARCH_RESULTS.length; i += 2) {
    const fieldPairs = SEARCH_RESULTS[i + 1];
    const entity = {};
    
    // 遍历字段-值对
    for (let j = 0; j < fieldPairs.length; j += 2) {
      const fieldName = fieldPairs[j];
      const fieldValue = fieldPairs[j + 1];
      const fieldDef = fieldsData.find(f => f.field === fieldName);
      
      if (!fieldDef) {
        entity[fieldName] = fieldValue;
        continue;
      }

      switch (fieldDef.type) {
        case 'number':
          entity[fieldName] = Number(fieldValue);
          break;
        case 'array':
          try {
            // 将JSON字符串解析为数组
            entity[fieldName] = JSON.parse(fieldValue);
          } catch (err) {
            // 解析失败时的降级处理（如单个元素转为数组）
            entity[fieldName] = [fieldValue];
          }
          break;
        default:
          entity[fieldName] = fieldValue;
          break;
      }
    }
    processedResults.push(entity);
  }
}

return processedResults;

3. 确保索引创建正确（前置条件） #

如果是手动创建索引而非Redis OM自动生成，需确保数组字段的索引定义包含完整路径：

FT.CREATE MassEmail:index ON JSON PREFIX 1 MassEmail: SCHEMA 
  $.createdDateTime AS createdDateTime NUMERIC 
  $.massEmailText AS massEmailText TEXT 
  $.massEmailSendToListUsers[*] AS massEmailSendToListUsers TAG 
  $.isDeleted AS isDeleted BOOLEAN

注：[*]用于索引数组中的每个元素，不影响通过$.massEmailSendToListUsers获取完整数组。

修改后，返回结果中的massEmailSendToListUsers会是包含所有元素的JS数组，数字字段也会转为Number类型。

内容的提问来源于stack exchange，提问作者Richard KeMiKaL GeNeRaL Denton