如何在TypeScript中定义存储动态MongoDB查询的对象类型

不用any类型也能实现动态构建MongoDB查询，核心思路是利用结构化类型约束查询对象，既满足TypeScript的类型检查，又避免大量重复类型声明。

方案一：使用官方类型定义（推荐） #

借助mongodb或mongoose包内置的查询类型，直接约束查询结构，同时复用你的集合文档类型。

步骤1：定义集合文档接口 #

先明确你的MongoDB集合对应的文档结构：

// 示例文档结构，根据实际业务调整
interface MealRecord {
  date: Date;
  lunch: string;
  dinner?: string;
  calories: number;
}

步骤2：导入官方查询类型 #

从mongodb包导入Filter类型（Mongoose用户替换为FilterQuery）：

import { Filter } from 'mongodb';
// Mongoose用户替换为：import { FilterQuery } from 'mongoose';

步骤3：动态构建查询 #

初始化查询对象为包含$and数组的结构，在switch逻辑中生成符合类型约束的查询条件，直接push到$and数组：

type QueryType = 'date_time' | 'select_lunch';

function buildDynamicQuery(type: QueryType, params: unknown) {
  // 初始化查询对象，类型约束为Filter<MealRecord>
  const query: Filter<MealRecord> = { $and: [] };

  switch (type) {
    case 'date_time': {
      const { dateA, dateB } = params as { dateA: string; dateB: string };
      // 生成符合类型约束的日期查询条件
      const dateCondition: Filter<MealRecord> = {
        date: { $gte: new Date(dateA), $lte: new Date(dateB) }
      };
      query.$and.push(dateCondition);
      break;
    }
    case 'select_lunch': {
      const { option } = params as { option: string };
      const lunchCondition: Filter<MealRecord> = {
        lunch: { $eq: option }
      };
      query.$and.push(lunchCondition);
      break;
    }
    // 扩展其他查询类型...
  }

  return query;
}

这种方式下，TypeScript会自动校验：

• 查询条件中的字段是否存在于MealRecord接口中
• 操作符（如$gte、$eq）是否符合对应字段的类型要求
• 避免非法的查询结构

方案二：自定义MongoDB查询类型 #

如果不想依赖第三方包的类型，可以自己定义通用的MongoDB查询结构类型：

// 定义MongoDB常用操作符
type MongoFieldOperator<T> = {
  $eq?: T;
  $gte?: T;
  $lte?: T;
  $in?: T[];
  $ne?: T;
  // 根据业务需求扩展其他操作符
};

// 定义通用查询类型
type MongoQuery<T> = 
  // 单个字段的查询条件
  { [K in keyof T]?: T[K] | MongoFieldOperator<T[K]> }
  // 逻辑操作符（如$and、$or）
  | { $and?: MongoQuery<T>[] }
  | { $or?: MongoQuery<T>[] };

之后用法和方案一一致，将Filter<MealRecord>替换为MongoQuery<MealRecord>即可，同样能实现类型安全的动态查询构建。

关键优势 #

• 完全避免any类型，保持TypeScript的类型校验能力
• 无需预定义所有可能的查询模板，通过通用类型覆盖所有合法查询结构
• 支持扩展任意查询场景（嵌套字段、数组查询等），官方类型或自定义类型均可灵活扩展

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