Mongoose使用populate查询ParkingComplex的houses字段返回空数组如何解决

核心原因分析 #

你遇到的populate后houses为空的问题，是Mongoose关联查询的常见问题，主要有以下几个可能的诱因：

• 关联的House文档不存在/已被软删除
• 模型注册顺序错误，导致Mongoose无法匹配到ref对应的House模型
• 全局查询中间件附加了隐藏过滤条件
• 字符串ref匹配失败

排查&解决步骤 #

1. 确认关联文档存在
   首先直接操作数据库查询House集合，确认60aaa827ec89de07e0fb8db1、60aaa827ec89de07e0fb8db2两个ID对应的文档真实存在，且isDeleted字段值为false。

2. 调整模型注册顺序
   保证HouseModel的注册逻辑执行在ParkingComplexModel注册之前，避免Mongoose解析ref时找不到对应的模型。

3. 手动指定populate关联模型
   populate时显式传入HouseModel，跳过字符串ref匹配逻辑，代码修改如下：

import HouseModel from './你HouseModel的导出路径'

getParkingComplex: async (parent, {uuid}) => {
  const data = await ParkingComplexModel.findById(uuid)
    .populate({
      path: 'houses',
      model: HouseModel,
      // 如果要包含软删除的文档可以加match条件
      // match: { isDeleted: { $ne: null } }
    })
    .exec()
  console.log(data)
  return data;
}

4. 检查全局查询中间件
   排查项目中是否为HouseSchema注册了pre('find')/pre('findOne')类的全局中间件，默认给查询附加了isDeleted: false之外的过滤条件，导致匹配不到关联文档。

5. 打印执行日志确认查询逻辑
   开启Mongoose调试模式，查看实际执行的populate查询语句是否符合预期：

// 全局开启Mongoose调试
mongoose.set('debug', true)

执行查询后可以在控制台看到完整的数据库查询语句，确认关联查询的集合、过滤条件是否正确。

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