Mongoose查询嵌套数组如何仅返回单个匹配元素

findOne查询条件中写的"voters.idCard": voteData.idCard仅用于筛选父级Election文档——即只要某条选举记录的voters数组里存在对应idCard的选民，这条父文档就会被命中。MongoDB默认不会自动裁剪返回的嵌套数组内容，因此父文档匹配成功后，整个voters数组会被完整返回。

方案1：投影阶段使用$elemMatch（单条匹配场景性能最优） #

如果确定idCard唯一、仅需要返回第一个匹配的选民，直接在select投影规则里加数组过滤逻辑即可，修改后代码如下：

const Elections = require("../models/Elections");
Elections.findOne({ 
  id: voteData.idElection,
  "voters.idCard": voteData.idCard, 
  "candidates.idCard": voteData.idCandidate
})
.select({
  electionMode: 1,
  candidates: 1,
  // 核心配置：仅返回voters数组中匹配idCard的项
  voters: { $elemMatch: { idCard: voteData.idCard } }
})
.lean().then(election => {
  // 返回的election.voters是长度为0或1的数组，索引0项即为匹配的选民
  const targetVoter = election.voters?.[0];
  // 后续业务逻辑
})

方案2：使用聚合管道（多数组过滤/多匹配项场景适用） #

如果需要同时过滤candidates数组、或者需要返回数组中所有符合条件的项，可以用聚合管道的$filter操作实现：

Elections.aggregate([
  // 先匹配目标父文档
  { $match: {
    id: voteData.idElection,
    "voters.idCard": voteData.idCard,
    "candidates.idCard": voteData.idCandidate
  }},
  // 裁剪字段+过滤嵌套数组
  { $project: {
    electionMode: 1,
    voters: {
      $filter: {
        input: "$voters",
        cond: { $eq: ["$$this.idCard", voteData.idCard] }
      }
    },
    candidates: {
      $filter: {
        input: "$candidates",
        cond: { $eq: ["$$this.idCard", voteData.idCandidate] }
      }
    }
  }}
]).then(res => {
  const election = res?.[0];
  const targetVoter = election?.voters?.[0];
  // 后续业务逻辑
})

方案3：查询后在JS层过滤（小数组场景最简单） #

如果单条选举记录下的voters数组长度很小，不需要修改查询逻辑，拿到完整数组后手动查找匹配项即可：

const Elections = require("../models/Elections");
Elections.findOne({ 
  id: voteData.idElection,
  "voters.idCard":voteData.idCard, 
  "candidates.idCard": voteData.idCandidate
})
.select(["candidates", "voters", "electionMode"])
.lean().then(election => {
  if (!election) return; // 处理未找到选举记录的情况
  // 手动查找匹配的选民
  const targetVoter = election.voters.find(v => v.idCard === voteData.idCard);
  // 后续业务逻辑
})

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