Mongoose嵌套文档中仅返回匹配数组元素及父级字段方案

在MongoDB中，默认查询只会返回匹配条件的整个文档，不会自动过滤嵌套数组内的非匹配元素。针对你多层嵌套（schools -> collections -> projects）的场景，需要通过聚合管道或投影过滤来实现仅返回目标project的需求，以下是两种可行方案：

方案一：使用聚合管道（推荐，适配多层嵌套） #

通过$filter和$map组合，层层过滤嵌套数组，精准保留匹配元素：

import { Injectable } from '@nestjs/common';
import { InjectModel } from '@nestjs/mongoose';
import { Model, Types } from 'mongoose';
import { YourDocument } from './your.schema'; // 替换为你的文档类型

@Injectable()
export class YourService {
  constructor(
    @InjectModel('YourModel') private readonly yourModel: Model<YourDocument>,
  ) {}

  async getTargetProject(
    rootId: string,
    targetSchoolId: string,
    targetCollectionId: string,
    targetProjectId: string,
  ) {
    return await this.yourModel.aggregate([
      // 先匹配根文档，缩小处理范围
      { $match: { _id: new Types.ObjectId(rootId) } },
      // 过滤出匹配的school
      {
        $project: {
          rootField: 1, // 显式保留需要的根字段，可添加多个
          schools: {
            $filter: {
              input: '$schools',
              as: 'school',
              cond: { $eq: ['$$school.schoolId', targetSchoolId] },
            },
          },
        },
      },
      // 过滤匹配school下的collection
      {
        $project: {
          rootField: 1,
          schools: {
            $map: {
              input: '$schools',
              as: 'school',
              in: {
                schoolId: '$$school.schoolId',
                name: '$$school.name', // 保留school的字段
                collections: {
                  $filter: {
                    input: '$$school.collections',
                    as: 'collection',
                    cond: { $eq: ['$$collection.collectionId', targetCollectionId] },
                  },
                },
              },
            },
          },
        },
      },
      // 过滤匹配collection下的project
      {
        $project: {
          rootField: 1,
          schools: {
            $map: {
              input: '$schools',
              as: 'school',
              in: {
                schoolId: '$$school.schoolId',
                name: '$$school.name',
                collections: {
                  $map: {
                    input: '$$school.collections',
                    as: 'collection',
                    in: {
                      collectionId: '$$collection.collectionId',
                      name: '$$collection.name', // 保留collection的字段
                      projects: {
                        $filter: {
                          input: '$$collection.projects',
                          as: 'project',
                          cond: { $eq: ['$$project.projectId', targetProjectId] },
                        },
                      },
                    },
                  },
                },
              },
            },
          },
        },
      },
    ]);
  }
}

说明： #

1. $match放在最前，先筛选根文档，减少后续数据处理量，提升性能；
2. 每层嵌套用$filter筛选目标数组元素，$map保留当前层级的非数组字段；
3. 根字段和层级字段可根据业务需求调整，显式列出需要保留的内容即可。

方案二：使用findOne结合投影过滤（简洁版） #

如果仅需返回单个文档，可直接在findOne的投影参数中嵌套$filter：

async getTargetProject(
  rootId: string,
  targetSchoolId: string,
  targetCollectionId: string,
  targetProjectId: string,
) {
  return await this.yourModel.findOne(
    { _id: rootId },
    {
      rootField: 1, // 保留根字段
      schools: {
        $filter: {
          input: '$schools',
          as: 'school',
          cond: { $eq: ['$$school.schoolId', targetSchoolId] },
          in: {
            schoolId: '$$school.schoolId',
            name: '$$school.name',
            collections: {
              $filter: {
                input: '$$school.collections',
                as: 'collection',
                cond: { $eq: ['$$collection.collectionId', targetCollectionId] },
                in: {
                  collectionId: '$$collection.collectionId',
                  name: '$$collection.name',
                  projects: {
                    $filter: {
                      input: '$$collection.projects',
                      as: 'project',
                      cond: { $eq: ['$$project.projectId', targetProjectId] },
                    },
                  },
                },
              },
            },
          },
        },
      },
    },
  );
}

注意： #

• 此写法需要显式列出各层级需要保留的字段，避免丢失非数组属性；
• 如果匹配的school/collection/project不存在，对应的数组会返回空数组，需在业务代码中处理该场景。

为什么之前的代码返回所有projects？ #

MongoDB的默认查询逻辑是：只要文档满足顶层匹配条件，就会返回整个文档（包括所有嵌套数组），不会自动过滤数组内的元素。必须通过$filter（投影或聚合阶段）主动筛选数组中符合条件的元素。

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