Mongoose调用populate报Cannot read properties of undefined错误

报错根因 #

抛出Cannot read properties of undefined (reading 'populate')的核心原因是Mongoose查询链式调用顺序错误，附带多个隐藏逻辑bug：

• 方法调用顺序颠倒：Mongoose中populate()、lean()、select()这类查询配置方法，必须在exec()触发查询执行之前调用。你当前的代码是先调用.exec(回调函数)触发查询，再在exec的返回值上链式调用populate。而exec()执行后不会返回Query查询实例，后续链式调用拿到的值是undefined，自然无法读取populate方法，直接触发类型错误。
• 返回值处理逻辑错误：findOne()查询只会返回单条匹配的文档对象，不是数组。你代码中判断data.length == 0、调用data.map()都是针对数组的写法，就算populate问题修复，这里也会抛出data.map is not a function的错误。
• 回调逻辑无阻断：查询出错时执行callback(error)后没有加return阻断，后续代码会继续执行，导致多次调用callback的异常。
• 缺空值兜底：直接读取关联字段、嵌套字段的属性（比如item.createdBy.fullName、item.fabricType[0].style[0].images[0]），如果关联字段不存在、嵌套数组为空，会抛出新的类型错误。

修复方案 #

调整查询链式调用顺序，修正单文档处理逻辑，补全错误阻断和空值兜底，修复后代码如下：

this.products.findOne(
    { _id: req.query.productId }, 
    { createdAt: 0, updatedAt: 0, isActive: 0, isDeleted: 0, __v: 0 }
)
.populate('createdBy')
.populate('category')
.populate('subCategory')
.lean()
.exec(function (error, data) {
    if (error) {
        return callback(error);
    }
    if (!data) {
        return callback(false, common.errorMsg("NO Details FOUND"));
    }
    // 处理单条文档，补全空值兜底
    const formatData = {
        productId: data._id,
        productName: data.productName,
        storeName: data.createdBy?.fullName || '',
        categoryName: data.category?.name || '',
        subCategoryName: data.subCategory?.name || '',
        image: data.fabricType?.[0]?.style?.[0]?.images?.[0] || '',
        price: data.price
    }
    return callback(false, common.successMsg("product", formatData));
})

调整点说明 #

• 把populate()、lean()全部移动到exec()之前，符合Mongoose查询构建的执行顺序，从根源解决undefined调用populate的错误。
• 去掉针对数组的length判断、map遍历逻辑，适配findOne返回单文档的特性。
• 所有错误分支加return阻断，避免重复调用callback。
• 用可选链操作符加默认值做空值兜底，避免嵌套字段、关联字段不存在时抛出属性读取错误；如果运行环境不支持ES2020可选链?.，换成逐层判断字段存在的普通写法即可。

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