Mongoose中find查询子文档时income返回undefined的原因探究

核心差异：返回值类型本质不同 #

• findOne()返回单个Mongoose文档实例：这个实例经过Mongoose的「水合」处理，完全继承了Schema定义的结构与方法，其中的子文档数组会被包装成DocumentArray类型——该类型自带id()这类子文档操作方法。
• find()返回Mongoose文档实例的普通JS数组：数组本身不具备文档的属性和方法，只有数组内的每个元素才是经过水合的文档实例。

你的问题根源 #

你用Client.find({"income._id": incomeId})查询后，直接把返回的数组当成单个文档去访问client.income——数组本身没有income属性，自然返回undefined，调用id()时就会触发「无法读取undefined的id属性」的报错。

而findOne()直接返回单个水合后的文档实例，它的income是被Mongoose识别的DocumentArray，因此能正常调用id()方法。

验证与解决办法 #

如果坚持使用find()，需要先从返回的数组中取出目标文档（通常取第一个元素），再操作子文档：

Client.find({"income._id": incomeId})
.then((clients) => {
  if (clients.length === 0) {
    // 处理无匹配文档的情况
    return;
  }
  const client = clients[0];
  const targetIncome = client.income.id(incomeId);
  // 后续业务操作
})

Mongoose底层逻辑补充 #

Mongoose的「水合」过程会把MongoDB返回的原始BSON数据，转换成绑定了Schema方法的文档实例：

• 处理单个文档时，Mongoose会递归处理所有子文档/子文档数组，给子文档数组挂载DocumentArray的专属方法（比如id()、push()、pull()等）。
• 处理文档数组时，Mongoose只会水合数组内的每个元素，但数组本身不会被包装成特殊类型，因此直接访问数组的文档属性会得到undefined。

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