NestJS+TypeScript+MongoDB用aggregate实现模糊搜索返回空结果求助

• 根本踩坑点1：你调用的.search()是MongoDB Atlas 托管服务专属的$search聚合阶段，并非自建/本地部署的开源版MongoDB原生支持的能力。自建Mongo没有预置Atlas Search引擎、也没有提前创建对应搜索索引的场景下，该阶段不会抛出明确语法错误，但会直接返回空结果，完全无法命中库内数据。
• 逻辑错误1：参数传入方式不对。text.query字段要求传入纯文本的搜索关键词，你直接把整个query查询对象塞进去，系统会将整个对象序列化为类似[object Object]的字符串作为检索词，自然匹配不到任何fullName字段的内容。
• 逻辑错误2：分页统计逻辑不一致。上方聚合走的是模糊检索条件，下方的countDocuments(query)用的是精确匹配的查询条件，统计出来的总数和实际模糊检索的结果完全不匹配，分页逻辑会出错。

方案1：如果使用MongoDB Atlas托管服务 #

首先需要在对应学生集合上，给fullName字段创建专属的文本搜索索引，再对现有代码做逻辑修正，示例代码：

async get(page: number, query: { keyword?: string }) {
  const offset = (page - 1) * 8;
  // 从查询参数里提取真正的搜索关键词，不要整个对象传入
  const searchKeyword = query.keyword || '';

  const pipeline = [];
  // 无搜索关键词时直接跳过搜索阶段，避免触发无索引的空返回
  if (searchKeyword) {
    pipeline.push({
      $search: {
        index: 'fullName_search_idx', // 必须指定提前创建的搜索索引名，不指定会默认找不存在的default索引
        text: {
          query: searchKeyword,
          path: 'fullName',
          fuzzy: {
            maxEdits: 2,
            prefixLength: 2
          }
        }
      }
    });
  }
  // 用facet把分页和统计放在同一个聚合管道里，保证检索条件完全一致
  pipeline.push({
    $facet: {
      items: [
        { $skip: offset },
        { $limit: 8 }
      ],
      totalCount: [
        { $count: 'total' }
      ]
    }
  })

  const [result] = await this.studentModel.aggregate(pipeline);
  return {
    items: result.items,
    count: result.totalCount[0]?.total || 0
  };
}

方案2：自建MongoDB场景（无需Atlas、无TypeScript兼容问题） #

如果不想依赖Atlas的托管能力，也不需要额外引入第三方插件，可以用Mongoose原生的正则匹配实现轻量模糊搜索，完全兼容TypeScript类型定义，不需要处理插件的TS兼容问题，示例代码：

async get(page: number, query: { keyword?: string }) {
  const offset = (page - 1) * 8;
  const searchKeyword = (query.keyword || '').trim();
  // 转义用户输入的正则特殊字符，避免正则注入和匹配异常
  const escapeRegExp = (text: string) => text.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');

  // 构造统一的查询过滤条件，分页和统计共用同一套逻辑
  const filter: Record<string, any> = {};
  if (searchKeyword) {
    // i标识代表不区分大小写匹配
    filter.fullName = new RegExp(escapeRegExp(searchKeyword), 'i');
  }

  const studentList = await this.studentModel
    .find(filter)
    .skip(offset)
    .limit(8);
  const totalCount = await this.studentModel.countDocuments(filter);

  return { items: studentList, count: totalCount };
}

• 性能提示：如果fullName字段的数据量超过10万条，可以给该字段添加普通B树索引，正则模糊匹配的前置过滤依然可以利用索引加速，不需要额外配置特殊的搜索索引。

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