NestJS查询MongoDB时出现Type 'Document[]'无法分配给自定义类型错误

DevOps 小满

2026-9-25

错误成因

原生MongoDB Node.js驱动的collection.find()方法默认返回的是Document[]类型，该类型仅包含MongoDB文档的通用属性，TypeScript无法自动推断其与自定义MyDataset类型的字段匹配关系，因此触发类型不兼容报错。

解决方法

以下是三种常用的解决方案，可根据业务场景选择：

方案一：查询时指定集合泛型
调用collection方法时直接传入自定义类型作为泛型参数，告知TypeScript该集合的文档结构符合MyDataset定义：

async getDatasets(): Promise<Array<MyDataset>> {
    const Collection = this.db.collection<MyDataset>('collection')
    const result = await Collection.find({}).toArray()
    return result
}

方案二：显式类型断言
如果可以100%确认数据库返回的文档字段与MyDataset完全匹配，可以直接对返回结果做类型断言：

async getDatasets(): Promise<Array<MyDataset>> {
    const Collection = this.db.collection('collection')
    const result = await Collection.find({}).toArray()
    return result as MyDataset[]
}

方案三：类实例化转换（推荐，带运行时校验）
如果需要保证运行时返回值完全符合类型定义，可给MyDataset新增构造转换逻辑，同时可补充字段校验规则避免数据库字段异常导致业务问题：

class MyDataset {
    group: string
    location: string
    type: string
    reported: Date

    constructor(doc: any) {
        this.group = doc.group
        this.location = doc.location
        this.type = doc.type
        this.reported = doc.reported
        // 可在此处补充字段合法性校验逻辑
    }
}

async getDatasets(): Promise<Array<MyDataset>> {
    const Collection = this.db.collection('collection')
    const result = await Collection.find({}).toArray()
    return result.map(doc => new MyDataset(doc))
}