Node.js + MongoDB：如何更新文档数组中指定title的page值？

你当前代码用$set直接替换整个lastViewed数组，导致原有元素被全部覆盖。要实现更新特定title对应的page值、保留数组其他元素的需求，需要利用MongoDB的数组定位符$定位目标元素，结合"先更新、无则添加"的逻辑来处理。

修改后的完整接口代码 #

router.post("/api/update", async (req, res) => {
  let { token, itemId, page } = req.body;

  if (!token) {
    return res.json({ status: 'error', error: 'wrong token' });
  }
  
  try {
    const userVerification = jwt.verify(token, JWT_SECRET);
    const _id = userVerification.id;
    const item = await Item.findById(itemId);
    
    if (!item) {
      return res.json({ status: 'error', error: 'item not found' });
    }

    // 1. 尝试更新已存在的对应title的page值
    const updateResult = await User.updateOne(
      { _id, "lastViewed.title": item.title },
      { $set: { "lastViewed.$.page": page } }
    );

    // 2. 如果没有找到匹配元素，就添加新记录到数组
    if (updateResult.modifiedCount === 0) {
      await User.updateOne(
        { _id },
        { $push: { lastViewed: { title: item.title, page: page } } }
      );
    }

    res.json({ status: 'ok' });
  } catch (err) {
    res.json({ status: 'error', error: 'wrong token' });
  }
});

关键逻辑说明 #

1. 精准定位更新

   • 查询条件{ _id, "lastViewed.title": item.title }：同时匹配用户ID和数组中指定title的元素
   • 更新操作{ $set: { "lastViewed.$.page": page } }：用数组定位符$指向匹配到的数组元素，仅更新其page字段，完全保留数组其他元素

2. 无则添加逻辑

   • 通过updateResult.modifiedCount判断是否成功更新：值为0表示数组中没有对应title的元素
   • 用$push将新的{title, page}对象追加到数组末尾，不会影响原有元素

如果需要确保同一个title在数组中唯一（避免重复添加），可以将$push替换为$addToSet，但注意$addToSet是基于整个对象的匹配（即只有当title和page都完全相同时才会跳过添加）。

内容的提问来源于stack exchange，提问作者Michal Fráter