Node.js中获取子文档时出现Unsupported projection option错误

首先咱们一步步拆解问题根源，再给出可行的解决方案：

1. 你的Schema定义存在语法错误 #

你当前的items字段写成[ item_id, item_name ]，这不是Mongoose Schema的正确写法——这种格式会被解析成包含两个字符串类型元素的普通数组，而不是你实际需要的「包含item_id和item_name属性的对象数组」。MongoDB无法识别这种错误的字段结构，才会抛出投影选项不支持的错误。

修正后的Schema应该是这样：

const { Schema, model } = require('mongoose');

const categorySchema = new Schema({ 
  category_id: String, // 明确指定字段类型，比如String/Number，根据你的业务需求调整
  name: String,
  items: [
    {
      item_id: String,
      item_name: String
    }
  ] 
});

const Category = model('Category', categorySchema);

2. 调整查询逻辑（两种可选方案） #

方案一：修正Schema后使用$elementMatch投影 #

修正Schema后，你原来的查询代码就能正常运行了。如果想更精准地返回匹配的子文档（而非带整个items数组的分类文档），可以加一步提取逻辑：

router.get('/:category/:item', async (req, res) => { 
  try { 
    const category = await Category.findOne( 
      { category_id: req.params.category }, 
      { items: { $elementMatch: { item_id: req.params.item } } }
    ); 
    // 提取匹配的子文档（处理无匹配的情况）
    const matchedItem = category?.items?.[0];
    res.status(200).send(matchedItem || { message: '目标子文档不存在' });
  } catch (err) {
    // 别忘了捕获异常，避免服务器崩溃
    res.status(500).send({ error: err.message });
  }
});

方案二：使用聚合管道（更灵活，适合复杂查询场景） #

如果需要直接返回匹配的子文档（而非嵌套在分类文档里），可以用MongoDB的聚合管道实现：

router.get('/:category/:item', async (req, res) => { 
  try { 
    const result = await Category.aggregate([
      // 第一步：匹配对应的分类
      { $match: { category_id: req.params.category } },
      // 第二步：过滤items数组，只保留匹配item_id的元素
      { $project: {
          matchedItem: {
            $filter: {
              input: '$items',
              cond: { $eq: ['$$this.item_id', req.params.item] }
            }
          }
        }
      },
      // 第三步：展开数组（如果只需要单个匹配项）
      { $unwind: '$matchedItem' },
      // 第四步：直接返回匹配的子文档作为根结果
      { $replaceRoot: { newRoot: '$matchedItem' } }
    ]);

    res.status(200).send(result[0] || { message: '目标子文档不存在' });
  } catch (err) {
    res.status(500).send({ error: err.message });
  }
});

错误原因总结 #

Unsupported projection option本质是因为Schema定义错误，导致MongoDB无法识别items为对象数组结构，进而无法解析$elementMatch这个投影选项。修正Schema后，MongoDB能正确理解字段结构，投影逻辑就能正常工作了。

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