Mongoose TypeScript ObjectId类型转换报错：string无法分配给Condition<ObjectId | undefined>类型

问题根源 #

你遇到的两个核心问题都是TypeScript类型定义匹配错误导致的：

1. _id是可选类型：你定义的接口继承了旧版Mongoose的Document类型，该类型默认将_id标记为可选。
2. find方法报错匹配到Callback类型：你传入的过滤对象不符合FilterQuery类型要求，TypeScript没有匹配到传过滤条件的重载，反而匹配到了仅传入回调函数的重载，因此抛出了看起来无关的类型错误。
3. 不要用mongoose.Schema.Types.ObjectId实例化ID：它只是Schema层面的类型标记，不是运行时可用的构造函数，实例化ObjectId永远使用mongoose.Types.ObjectId。

解决方案 #

方案1：推荐，使用新版Mongoose类型定义（Mongoose 6.x及以上适用） #

新版Mongoose不再推荐让业务接口继承Document类型，改用纯数据接口 + HydratedDocument的写法，自动处理_id等内置字段的类型：

import { Schema, model, HydratedDocument, Model, LeanDocument, Types } from 'mongoose';

// 1. 定义纯业务数据接口，不带任何Mongoose内置属性
export interface Language {
  langCode: string;
  locale: string;
  createdAt: Date;
  updatedAt: Date;
}

// 2. 定义Mongoose文档类型，自动携带_id等内置属性
type LanguageDocument = HydratedDocument<Language>;

// 3. 定义带静态方法的模型类型
interface LanguageModel extends Model<Language> {
  mapToLanguage(language: LeanDocument<Language> | LanguageDocument): {
    id: string;
    langCode: string;
    locale: string;
  };
}

// 4. Schema定义
const languageSchema = new Schema<Language, LanguageModel>(
  {
    langCode: { type: String, required: true, trim: true },
    locale: { type: String, unique: true, required: true, trim: true },
  },
  { collection: 'language', timestamps: true, versionKey: false },
);

// 5. 静态方法实现，此时_id是必选类型，不需要可选链
languageSchema.statics.mapToLanguage = function (language: LeanDocument<Language> | LanguageDocument) {
  return {
    id: language._id.toString(),
    langCode: language.langCode,
    locale: language.locale,
  };
};

export const LanguageModel = model<Language, LanguageModel>('Language', languageSchema);

修改后查询代码可直接使用，两种写法都不会报类型错误：

export async function findLanguagesByIds(languageIds: string[]) {
  // 写法1：直接传字符串数组，Mongoose运行时会自动转换为ObjectId
  return LanguageModel.find({ _id: { $in: languageIds } }).lean();

  // 写法2：手动转换为ObjectId实例
  // const objectIds = languageIds.map(id => new Types.ObjectId(id));
  // return LanguageModel.find({ _id: { $in: objectIds } }).lean();
}

方案2：临时兼容，不需要修改原有类型定义 #

如果不想改动现有代码结构，可以给过滤条件明确声明FilterQuery类型，强制TypeScript匹配正确的方法重载：

import { FilterQuery } from 'mongoose';

export async function findLanguagesByIds(languageIds: string[]) {
  const filter: FilterQuery<LanguageSchema> = { _id: { $in: languageIds } };
  return LanguageModel.find(filter).lean();
}

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