如何为带操作符的MongoDB筛选器参数正确定义类型？

我在数据库层实现了以下函数：

public async findByFilter(filter: Partial<InterfaceMongooseModel>): Promise<InterfaceMongooseModel> {
    return MongooseModel.findOne(filter);
}

该函数在多数场景下正常工作，但使用包含MongoDB操作符的筛选器时会触发类型错误，示例筛选器如下：

{
  property: value,
  createdDate: { $gte: oneDayAgo },
}

目前我只能将参数类型改为object来绕过错误，但这个类型过于宽泛，无法提供有效的类型提示与校验，希望找到更精准的类型定义方案。

最优解决方案 #

直接使用Mongoose内置的*FilterQuery<T>*类型，它是专门为MongoDB查询筛选器设计的类型，既支持普通键值对查询，也兼容带操作符的查询条件。

修改后的代码如下：

import { FilterQuery } from 'mongoose';

public async findByFilter(filter: FilterQuery<InterfaceMongooseModel>): Promise<InterfaceMongooseModel> {
    return MongooseModel.findOne(filter);
}

方案优势 #

• FilterQuery<InterfaceMongooseModel>会基于你的模型接口生成合法的查询类型，允许字段值为原始类型，也支持$gte、$lte、$in等所有MongoDB查询操作符
• 相比Partial<InterfaceMongooseModel>，完美适配MongoDB的查询语法；相比宽泛的object，能提供完整的类型校验与自动提示，避免传入非法字段或无效操作符

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