Express TypeScript下Mongoose外键关联查询ObjectId类型失效报错

一、解决「ObjectId类型不兼容Condition类型」的TS报错 #

报错根源 #

Mongoose v6+版本的TypeScript类型校验规则更新后，直接以函数形式调用Mongoose.Types.ObjectId(入参)返回的实例，无法被识别为合法的查询条件值，因此触发严格模式的类型不兼容提示。

修正步骤 #

• 引入参数合法性前置校验，避免非法字符串触发运行时错误，使用Mongoose内置的isValidObjectId方法校验传入的country_id格式
• 通过new关键字实例化ObjectId对象，替换原来的函数调用写法，即可匹配查询参数的类型要求

// 修正后的查询片段
if (!Mongoose.isValidObjectId(country_id)) {
  throw new Error('country_id参数格式非法，无法匹配ObjectId规则');
}
const countryId = new Mongoose.Types.ObjectId(country_id);
const data = await Cstate.find({ country: countryId });

二、解决「返回数据不匹配ICstate文档接口」的类型问题 #

现有接口的问题点 #

原ICstate定义未对齐Mongoose文档的实际结构，存在3处类型偏差：

• 手动重写_id字段定义为string | number，会覆盖Document父类自带的_id: Types.ObjectId类型，引发类型冲突
• 未包含schema开启timestamps后自动生成的createdAt、updatedAt字段类型
• 模型注册时未将接口作为泛型传入，导致Mongoose默认返回无类型的文档对象

修正步骤 #

• 重写ICstate接口，对齐实际文档结构，移除冗余的_id手动定义

import { Document, Types } from 'mongoose';
export interface ICstate extends Document {
  name: string;
  country: Types.ObjectId;
  createdAt: Date;
  updatedAt: Date;
}

• 注册Mongoose模型时绑定ICstate泛型，让模型方法自动推导正确的返回类型

// 替换原有无泛型的模型注册写法
export const Cstate = model<ICstate>('Cstate', cstateSchema);

• 去掉查询方法返回值的Promise<any>标注，TS会自动根据模型泛型推导出返回值为ICstate[]类型，无需手动做类型断言

完整修正后的查询方法 #

public getCstateByCountry = async (country_id: string) => {
  if (!Mongoose.isValidObjectId(country_id)) {
    throw new Error('country_id参数格式非法');
  }
  const countryId = new Mongoose.Types.ObjectId(country_id);
  // 返回值自动匹配ICstate[]类型，无类型报错
  const data = await Cstate.find({ country: countryId });
  return data;
};

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