直接用 collection<T>() 指定泛型类型是最简单、最可靠的强类型方式，无需继承 Document 或依赖 Mongoose 自动推断；它基于 MongoDB 官方驱动原生泛型，为 find()、insertOne() 等方法提供字段级类型检查，要求 T 为纯对象接口（如 interface User { _id: ObjectId; email: string; }），避免与 mongoose.Document 混用。
直接用 collection<T>() 指定泛型类型是最简单、最可靠的强类型方式，不需要额外接口继承 Document，也不依赖 Mongoose 的自动推断。
用 collection<T>() 显式声明集合类型
Node.js MongoDB 官方驱动（mongodb）原生支持泛型，collection<T>() 是唯一需要你主动写的类型锚点。它让 find()、insertOne()、updateOne() 等方法的输入/输出自动获得字段级类型检查。
常见错误现象：不加泛型时，find({ name: "Alice" }) 中的 name 不报错，哪怕集合里根本没有这个字段；查出来的结果也全是 any。
- 必须确保
T是一个 plain object 接口（不要 extendsDocument或其他运行时类） - 接口中未声明的字段在查询条件或更新操作中会被视为
any—— 例如interface User { email: string; }，那么find({ age: 25 })不会报错，但这是隐患 - 嵌套字段需完整展开，不能用
[key: string]: any破坏类型收敛
避免和 mongoose.Document 混用
如果你同时用了 Mongoose 和官方驱动，别把 Mongoose 的 IUser extends Document 直接塞进 collection<IUser>()。Mongoose 的 Document 带有大量运行时方法（如 save()、toObject()），而官方驱动只处理纯数据对象。
使用场景：纯 Node.js + MongoDB 驱动（无 Mongoose）时，Document 类型完全无关；用了 Mongoose 就该用它的 Model<T> 和 schema 推断，而不是混搭。
- 错误写法：
const coll = db.collection<IUser & Document>("users")—— 类型膨胀且无意义 - 正确做法：驱动归驱动，用
interface User { _id: ObjectId; email: string; }；Mongoose 归 Mongoose，用model<UserDocument>("User", schema) - 性能影响：混用不会拖慢运行时，但会让 TypeScript 编译器更难推导，补全变弱、错误提示变模糊
字段缺失与可选属性的实际处理
数据库文档天然稀疏，TypeScript 接口却倾向“全量定义”。直接标 age?: number 能解决部分问题，但 find().toArray() 返回的数组里每个元素仍可能缺字段 —— 类型系统不会帮你做运行时校验。
容易踩的坑：以为加了 ? 就安全了，结果在 user.age.toFixed(0) 处崩溃。
- 对必填字段（如
_id、email），保持非可选；对真正可空的字段（如avatarUrl?: string），明确标? - 如果业务逻辑常访问深层嵌套（如
profile?.address?.city），建议用Partial<Profile>或单独定义ProfileInput/ProfileOutput分离读写契约 - 不要依赖接口类型做运行时防护 —— 它只在编译期起作用；必要时配合
Zod或io-ts做运行时解析
最易被忽略的一点：类型安全 ≠ 数据安全。接口再严谨，也不能防止插入非法值或查询不存在字段 —— collection<User>("users") 只约束你写的代码，不约束数据库里的实际内容。真要兜底，得靠 schema validation（MongoDB 5.0+ 的 JSON Schema）或应用层中间件校验。
