如何为带projection的MongoDB查询结果设置正确的TypeScript类型

带projection的MongoDB查询场景下，优先使用驱动内置泛型重载+类型复用的方案，既无冗余也能保证类型安全，远优于你提到的两种方案。

第一步：复用基础类型避免重复定义 #

用TypeScript内置的Pick工具类型，从原始文档类型直接提取视图需要的字段，不需要重复写接口定义，后续修改字段时只需修改原始接口一处即可同步所有衍生视图类型：

import { ObjectId, Db, Collection, Filter } from 'mongodb'

// 原始集合存储的全量字段类型
interface User {
    _id?: ObjectId
    username: string
    foo: number
}

// 直接从User提取投影需要的字段，无需重复声明
type UserView = Pick<User, '_id' | 'username'>

第二步：使用查询方法的泛型重载指定返回类型 #

MongoDB官方Node.js驱动的find/findOne等查询方法本身支持传入返回类型的泛型参数，不需要额外创建集合实例，也不需要手动类型断言：

class UserRepository {
    private collection: Collection<User>
    
    constructor(db: Db) {
        this.collection = db.collection<User>('User')
    }

    public async getUserById(id: ObjectId): Promise<UserView | null> {
        // 直接在findOne后指定返回类型泛型即可
        return this.collection.findOne<UserView>(
            { _id: { $eq: id } } as Filter<User>, 
            { projection: { _id: 1, username: 1 } }
        )
    }
}

进阶：强制投影与返回类型对齐（可选） #

如果想要彻底避免手滑写错投影字段，可以封装一个简单的工具类型约束投影的字段范围，TypeScript会在开发阶段直接报错提示不匹配的字段：

// 约束投影只能使用目标类型里存在的字段
type ProjectionOf<T> = {
    [K in keyof T]?: 1 | 0
}

// 封装后的查询方法
async function findOneWithProjection<TSchema, TResult = TSchema>(
    collection: Collection<TSchema>,
    query: Filter<TSchema>,
    projection: ProjectionOf<TResult>
): Promise<TResult | null> {
    return collection.findOne<TResult>(query, { projection })
}

// 使用示例，传错投影字段会直接触发TS报错
public async getUserById(id: ObjectId): Promise<UserView | null> {
    return findOneWithProjection<User, UserView>(
        this.collection,
        { _id: { $eq: id } },
        // 这里如果写foo:1会直接报错，因为foo不在UserView的字段里
        { _id: 1, username: 1 }
    )
}

原有方案的缺陷说明 #

• 多集合实例方案：冗余度极高，每新增一种视图类型就要新增一个集合实例属性，完全没有运行时价值，只会徒增维护成本。
• 手动类型断言方案：类型不安全，如果你后续修改了投影字段但是忘记同步断言的类型，TypeScript不会抛出任何错误，会埋下运行时字段缺失的隐患。

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