最稳妥的通用 CRUD 封装路径是直接用 Mongoose + TypeScript 接口定义,因其提供类型安全、自动补全、schema 校验、中间件等能力,而原生 mongodb 驱动类型擦除严重、缺乏内置约束且易引发 runtime 错误。

直接用 Mongoose + TypeScript 接口定义是最稳妥的通用 CRUD 封装路径,不建议手写连接池、手动管理 Db 实例或裸调 mongodb 驱动 —— 类型安全、自动补全、IDE 支持和错误提示会立刻掉一大截。
为什么不用原生 mongodb 驱动封装通用 CRUD?
原生驱动(mongodb 包)返回的 Document 是 any 或 Record<string any></string>,即使你传入泛型 T,collection<t>().find().toArray()</t> 的结果类型也常被擦除,尤其在嵌套字段、ObjectId、Date 等类型上极易失准。更麻烦的是:
-
insertOne和updateOne的返回值类型(如InsertOneWriteOpResult)与业务数据无关,无法自然映射到你的实体 - 没有内置的 schema 校验、中间件、默认值、虚拟字段等能力,所有约束得靠手动
if判断 -
ObjectId字段必须显式 import 并 cast,稍不注意就 runtime 报错:TypeError: ObjectId is not a constructor
用 Mongoose 定义接口 + 泛型模型是核心做法
关键不是“泛型套泛型”,而是让每个 Model 本身携带完整类型信息,再通过工厂函数复用操作逻辑。例如:
interface IUser {
_id: Types.ObjectId;
name: string;
email: string;
createdAt: Date;
}
const userSchema = new Schema<IUser>({
name: { type: String, required: true },
email: { type: String, required: true, unique: true },
createdAt: { type: Date, default: Date.now }
});
export const User = model<IUser>('User', userSchema);
这样 User.findById 返回的就是 Promise<iuser null></iuser>,User.create 参数也受 IUser 约束 —— 类型从 schema 定义那一刻就固化了,不需要额外泛型推导。
通用 CRUD 方法可封装为:
Biome 是一个基于 Rust 的高性能工具链,适用于 JavaScript、TypeScript、JSX、JSON、CSS 和 GraphQL,它将格式化和 linting 统一到一个工具中。具有 97% 的 Prettier 兼容性以及超过 450 条 lint 规则,Biome 以显著更快的执行速度取代了 ESLint 和 Prettier。
-
createOne<t>(model: Model<t>, data: T): Promise<t></t></t></t>—— 但实际中model.create(data)已自带类型,无需再包一层 - 真正要封装的是跨模型共用的逻辑:软删除标记、审计字段填充、权限过滤条件注入
- 避免把
find、updateOne等基础方法再抽象成“通用函数”,那只会增加类型断言和运行时风险
如何让多个 Model 复用同一套 CRUD 逻辑?
靠继承 + 抽象类 + 实例方法,而不是靠顶层泛型函数。例如:
abstract class BaseModel<T> {
protected model: Model<T>;
constructor(model: Model<T>) {
this.model = model;
}
async create(data: Partial<T>): Promise<T> {
return this.model.create(data);
}
async findById(id: string | Types.ObjectId): Promise<T | null> {
return this.model.findById(id).lean().exec();
}
}
class UserService extends BaseModel<IUser> {
constructor() {
super(User);
}
}
这种结构下,UserService 的所有方法都天然具备 IUser 类型上下文,IDE 能精准提示字段,编译器能捕获 user.createdAt.toISOString() 这类合法调用,也能报错 user.nonExistField。
容易踩的坑:
- 别在抽象类里写
static通用方法并传入Model—— TypeScript 对静态泛型推导支持弱,容易丢失类型 -
.lean()后返回 plain object,Types.ObjectId会变成字符串,若需保持 ObjectId 实例,去掉.lean()并确保接口中声明为Types.ObjectId - 环境变量中的 MongoDB 连接字符串必须包含
?retryWrites=true&w=majority(新驱动要求),否则connect()可能静默失败
最易被忽略的一点:Mongoose 的 Document 类型和纯 interface 类型不是一回事;IUser 是文档结构,IUser & Document 才是实例类型。如果你在 service 层需要调用 doc.save(),就必须用后者,否则类型检查会过不了 —— 这个细节不查文档几乎没人主动意识到。

















