Mongoose FilterQuery类型定义报错：$where属性类型不兼容问题

你需要基于Mongoose的官方类型定义调整过滤器类型，这是解决该类型报错的最优方案。

报错核心原因 #

你自定义的FilterQueryType没有和Mongoose的官方FilterQuery泛型绑定，TS做类型推断时会把展开的req.Auth.Filter识别为通用的MongoDB查询对象，和User模型对应的FilterQuery<UserType>字段约束不匹配，才会出现$where字段类型不兼容、多余字段不识别的报错。

具体修复步骤 #

• 第一步：复用Mongoose官方的FilterQuery泛型定义你的权限过滤器类型，传入对应模型的类型做约束：

import { FilterQuery } from "mongoose";
// 替换为你自己定义的User模型类型路径
import { UserType } from "./models/User";

// 继承官方泛型，自动对齐User模型的字段、查询操作符类型约束
interface AuthFilterType extends FilterQuery<UserType> {
  // 你自定义的特殊查询字段可以在这里补
  someInvalidFieldToReturnNothing?: string;
}

• 第二步：将req.Auth.Filter的类型声明为上面定义的AuthFilterType，替换原来的FilterQueryType即可。

如果需要快速临时解决，也可以用类型断言兜底，不过不推荐长期使用：

const user = await User.findOne({
    _id: userId,
    ...req.Auth.Filter
// 显式断言为User模型对应的查询类型
} as FilterQuery<UserType>)

如果你的权限过滤器是多模型通用的，可以把它定义为泛型，适配不同模型的查询类型校验：

// 泛型定义，适配任意模型的查询过滤
interface AuthFilterType<T = any> extends FilterQuery<T> {
  someInvalidFieldToReturnNothing?: string;
}

// 使用时指定对应模型类型即可
const userFilter: AuthFilterType<UserType> = req.Auth.Filter;
const orderFilter: AuthFilterType<OrderType> = req.Auth.Filter;

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