Mongoose查询Customer的contacts数组指定_id Contact对象却返回整个Customer文档

• 现有代码返回完整Customer对象的原因：Mongoose的findOne默认会返回匹配查询条件的完整父级文档，哪怕查询条件命中了嵌套contacts数组里的某条记录，也不会自动裁剪冗余字段，更不会单独返回数组中匹配的Contact对象。
• 单独用Contact.findOne查询返回null的原因：你定义的contactSchema是嵌套在Customer Schema内的子文档，没有通过mongoose.model()注册为独立的Mongoose模型，所有Contact数据都存储在Customer集合的contacts数组字段中，没有独立的存储集合，自然无法通过独立的Contact模型查询到结果。

方式1：利用位置投影运算符精准提取单条Contact #

这种方式查询性能最优，适合单条ID精确匹配的场景，核心是借助Mongoose的$位置运算符，在查询投影层面只返回数组中匹配条件的那一项，避免返回冗余的Customer全量字段。
改写后的路由代码：

router.route('/customers/:id/contact/:contacts_id').get((req, res) => {
    Customer.findOne(
        // 原有的匹配查询条件无需调整
        {
            "_id": req.params.id,
            "contacts._id": req.params.contacts_id
        },
        // 新增投影规则，裁剪不需要的返回内容
        {
            "_id": 0, // 关闭Customer自身_id的返回
            "contacts.$": 1 // 仅返回contacts数组中第一个匹配查询条件的元素
        },
        (err, customer) => {
            // 补充错误响应逻辑，避免出错时挂起请求
            if (err) {
                return res.status(500).json({ error: err });
            }
            // 从返回的数组中取出目标Contact对象直接返回
            const targetContact = customer.contacts[0];
            res.json(targetContact);
        }
    )
})

注意：如果路由参数中的ID是字符串格式，需要确认Mongoose的Schema配置了自动类型转换，否则可以手动将参数转为ObjectId类型后再传入查询条件，避免因为类型不匹配导致查询失效。

方式2：通过聚合管道灵活筛选Contact #

如果后续需要处理更复杂的嵌套数组匹配逻辑，可以使用聚合管道的数组筛选能力实现提取，适合扩展性要求更高的场景：

const mongoose = require('mongoose');
router.route('/customers/:id/contact/:contacts_id').get((req, res) => {
    Customer.aggregate([
        // 匹配目标Customer文档
        {
            $match: {
                _id: new mongoose.Types.ObjectId(req.params.id)
            }
        },
        // 筛选contacts数组中符合ID条件的元素
        {
            $project: {
                matchedContact: {
                    $filter: {
                        input: "$contacts",
                        as: "item",
                        cond: { $eq: ["$$item._id", new mongoose.Types.ObjectId(req.params.contacts_id)] }
                    }
                }
            }
        },
        // 将筛选后的单元素数组拆为独立字段
        { $unwind: "$matchedContact" }
    ])
    .then(queryResult => {
        if (!queryResult.length) {
            return res.status(404).json({ message: "未找到对应联系记录" });
        }
        res.json(queryResult[0].matchedContact);
    })
    .catch(err => {
        res.status(500).json({ error: err });
    })
})

内容的提问来源于stack exchange，提问作者G.Mijal