如何用Mongoose的createIndexes()实现全文匹配搜索API？

原代码核心问题 #

• 每次查询时调用createIndexes()逻辑错误：索引只需初始化创建一次，重复调用会浪费资源且无法生效。
• fieldsAsRaw参数使用错误：该字段用于传递原始索引规则，而非搜索关键词。
• 查询语法错误：find({index})不符合Mongoose查询规范，无法触发全文搜索逻辑。

正确实现步骤 #

1. 创建覆盖多字段（含嵌套对象）的文本索引 #

索引需一次性创建，可通过两种方式实现：

方式一：Schema定义阶段直接声明

确保嵌套对象中需要搜索的字段也开启text: true，再创建复合文本索引：

// 先定义嵌套Schema并开启文本索引
@Schema()
export class HhData {
  @Prop({ text: true })
  name: string;
  // 其他需要搜索的字段同理设置text: true
}

@Schema()
export class TopPageAdvantages {
  @Prop({ text: true })
  title: string;
  @Prop({ text: true })
  description: string;
}

// 主Schema定义
@Schema()
export class TopPageModel {
  @Prop({ enum: TopLevelCategory })
  firstCategory: TopLevelCategory;

  @Prop({ required: true })
  secondCategory: string;

  @Prop({ required: true, unique: true })
  alias: string;

  @Prop({ text: true })
  title: string;

  @Prop({ required: true })
  category: string;

  @Prop(HhData)
  hh?: HhData;

  @Prop([TopPageAdvantages])
  advantages: [TopPageAdvantages];

  @Prop({ text: true })
  seoText: string;

  @Prop({ required: true })
  tagsTitle: string;

  @Prop([String], { text: true }) // 数组字符串字段开启文本索引
  tags: [string];
}

// 创建复合文本索引
export const TopPageSchemaFactory = SchemaFactory.createForClass(TopPageModel);
TopPageSchemaFactory.index(
  {
    title: 'text',
    seoText: 'text',
    'hh.name': 'text', // 嵌套对象字段用点路径指定
    'advantages.title': 'text', // 数组嵌套对象字段
    'advantages.description': 'text',
    tags: 'text'
  },
  { name: 'FullTextIndex' } // 可选：给索引命名便于管理
);

方式二：服务初始化时动态创建

适合需要灵活调整索引规则的场景，在服务启动时执行一次：

// 在TopPageService中添加初始化逻辑
async onModuleInit() {
  await this.topPageModel.createIndexes({
    fields: {
      title: 'text',
      seoText: 'text',
      'hh.name': 'text',
      'advantages.title': 'text',
      'advantages.description': 'text',
      tags: 'text'
    },
    name: 'FullTextIndex'
  });
}

2. 修正全文搜索方法 #

使用MongoDB原生$text操作符实现全文搜索：

// TopPageService
async findByText(text: string) {
  // 基础全文搜索
  return this.topPageModel.find({
    $text: { $search: text }
  });

  // 如果需要精确匹配短语，替换为：
  // return this.topPageModel.find({
  //   $text: { $phrase: text }
  // });
}

3. 关键注意事项 #

• 数组类型的字符串字段（如tags）开启text: true后，数组内每个元素都会被纳入搜索范围。
• 嵌套对象字段必须通过点路径（如'hh.name'）指定，才能被文本索引覆盖。
• 避免使用通配符索引{ '$**': 'text' }（覆盖所有字符串字段），会导致索引体积过大、搜索精度降低，建议按需指定字段。

内容的提问来源于stack exchange，提问作者Виталий Брынза