NestJS Mongoose嵌套populate时子文档虚拟id字段缺失问题

两个问题本质是同一个原因：嵌套在子文档数组下的二级populate不会自动继承顶层查询的lean配置，mongoose-lean-virtuals插件也不会自动对深层populate的外部集合文档生效。

• 你提到的次要问题（必须单独给desk加lean配置才不会返回原生Mongo文档）：markers是Map集合的原生内嵌子文档，属于主文档结构的一部分，自然会继承顶层的lean设置；但desk是markers字段下关联外部Desk集合populate出来的文档，不属于Map主文档的原生结构，不会自动继承顶层配置，必须单独指定。
• 核心问题（desk丢失id虚拟字段）：你在desk的populate配置里只写了lean: true，没有给lean明确开启virtuals开关，同时你直接传TS类作为populate的model参数，会导致DeskSchema上绑定的mongoose-lean-virtuals插件逻辑无法被正确加载，自然不会生成id虚拟字段。

具体修复操作 #

1. 所有populate路径的model参数不要直接传入TS类，改用你在MongooseModule.forFeature()中注册时对应的字符串模型名（比如'Image'、'Desk'），保证mongoose能正确加载对应Schema上注册的插件。
2. 给desk的嵌套populate明确传入带virtuals开关的lean配置，不要只写布尔值lean: true。
3. 你之前写的每层populate的transform逻辑可以删掉，最后统一遍历实例化Map类的时候，嵌套的对象会自动走类的构造函数逻辑，减少冗余代码。

修复后的查询代码如下：

async findAll(): Promise<Map[]> {
  return (await this.mapModel.find()
    .populate({
      path: 'image',
      model: 'Image',
    })
    .populate({
      path: 'markers',
      model: 'Marker',
      populate: {
        path: 'desk',
        model: 'Desk',
        options: { 
          lean: { virtuals: true } // 明确开启虚拟字段，和顶层配置保持一致
        },
      }
    })
    .lean({ virtuals: true })
    .exec()
  ).map(map => new Map(map))
}

补充避坑 #

如果改完后依然拿不到desk的id字段，先确认Desk模型已经在当前模块的MongooseModule.forFeature()中完成注册，否则字符串形式的模型名会触发找不到模型的报错；另外确认DeskSchema上确实已经注册了mongoose-lean-virtuals插件，从你贴的代码看这部分配置是正确的，只要populate时正确加载对应Schema就会正常生成id虚拟字段。

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