如何使用 Mongoose 查询包含指定用户 ID 的已收藏文章-js教程-PHP中文网

如何使用 Mongoose 查询包含指定用户 ID 的已收藏文章

本文详解如何正确实现“用户收藏文章”功能，重点解决因误用数组方法导致的 Cannot read properties of undefined (reading 'includes') 错误，并提供符合 Mongoose 最佳实践的查询方案。

本文详解如何正确实现“用户收藏文章”功能，重点解决因误用数组方法导致的 `cannot read properties of undefined (reading 'includes')` 错误，并提供符合 mongoose 最佳实践的查询方案。

在构建社交类或内容平台时，「收藏（Bookmark）」是高频需求。其核心逻辑是：将用户 ID 存入文章文档的 saves 数组中；当用户请求“我的收藏”时，需高效查出所有 saves 字段包含该用户 ID 的文章。但初学者常因混淆前端数组操作与 MongoDB 查询语法而报错——例如 post.saves.includes(userId) 会失败，因为 post 是一个 Mongoose Query 对象（或 Promise）而非实际文档数组，且 .find() 返回的是 Promise，不能直接调用 .includes()。

✅ 正确做法：交由 MongoDB 原生查询处理

Mongoose 支持对数组字段使用值匹配语法：{ saves: userId }。MongoDB 会自动检查 saves 数组中是否存在等于 userId 的元素（等价于 $in: [userId] 的单值简化写法），无需手动遍历或调用 JavaScript 方法。

首先，请确保 Schema 定义规范（注意方括号语法）：

// PostModel.js
saves: [{
  type: mongoose.Schema.Types.ObjectId,
  ref: "User",
  default: []
}],
likes: [{
  type: mongoose.Schema.Types.ObjectId,
  ref: "User",
  default: []
}]

⚠️ 关键修正：type: [ObjectId] 应写作 type: [{ ObjectId }] —— 后者明确声明这是一个对象 ID 元素组成的数组，避免 Mongoose 类型推断异常。

接着，重写控制器函数，删除错误的中间赋值与嵌套查询：

// controller.js
const getSavedPosts = async (req, res) => {
  try {
    // ✅ 安全获取当前用户 ID（建议增加空值校验）
    if (!req.user || !req.user._id) {
      return res.status(401).json({ message: "Unauthorized: User not authenticated" });
    }
    const userId = req.user._id;

    // ✅ 直接使用 Mongoose 查询：查找 saves 数组包含 userId 的所有文章
    const userSavedPost = await Post.find({ saves: userId }).populate('postedBy', 'username profilePic');

    // ✅ 响应标准化：始终返回 JSON，区分有无数据场景
    if (userSavedPost.length > 0) {
      res.status(200).json({
        success: true,
        count: userSavedPost.length,
        posts: userSavedPost
      });
    } else {
      res.status(200).json({
        success: true,
        message: "No saved posts found",
        posts: []
      });
    }
  } catch (err) {
    console.error("Failed to fetch saved posts:", err);
    res.status(500).json({
      success: false,
      message: "Internal server error"
    });
  }
};

? 补充说明与最佳实践

不要手动 .includes()：Post.find() 返回 Promise，.find().saves 不存在；即使 await Post.find() 得到数组，post.saves.includes() 也需遍历每个 post，效率远低于数据库层筛选。
安全校验 req.user：JWT 或 Session 解析失败时 req.user 可能为 undefined，务必前置校验。
善用 .populate()：如需返回发布者用户名、头像等信息，添加 .populate('postedBy', 'username avatar') 可自动关联查询。
错误处理不暴露细节：生产环境切勿返回 err.message，防止敏感路径或配置泄露。
性能提示：为 saves 字段添加索引可显著提升查询速度（尤其数据量大时）：
```
// 在 Schema 中添加
postSchema.index({ saves: 1 });
```