基于Mongoose populate()实现用户收藏条目的列表渲染与原文档展示

现有代码的问题定位 #

• 传参层级错位：使用find({_id: id})查询时，返回值是匹配用户组成的数组，你直接把这个用户数组赋值给视图的savedArticles变量，和预期的“收藏文章列表”结构完全不符。你控制台看到的两个Article对象，其实是数组里唯一用户文档内部、被populate完成的savedArticles字段值，不是数组本身的元素。
• populate字段截断：.populate('savedArticles', 'title')的第二个参数是关联查询的字段白名单，该写法只会拉取关联Article的_id和title字段，剩余字段比如导演、年份、封面图等都会被过滤掉，无法返回给前端。
• 视图取值路径错误：在EJS循环中直接取savedArticles[i].savedArticles，这个路径对应的是“用户数组第i个元素的savedArticles字段”，没有对数组结构做正确拆解，自然无法渲染有效内容。

修正实现步骤 #

1. 调整路由查询与传参逻辑 #

单用户匹配优先使用findById，避免返回数组结构；populate时移除字段白名单，拉取关联Article的全部需要字段；将用户文档内部的savedArticles数组单独传递给视图层：

router.get('/savedItems/:id/', checkAuthenticated, (req, res) => {
  const id = req.params.id;
  mongoose.model('Users').findById(id)
    // 不传入第二个字段参数，默认返回关联Article的全部业务字段
    // 如果需要控制返回字段，可写为 .populate('savedArticles', 'title director year coverImg')
    .populate('savedArticles')
    .exec(function(err, currentUser) {
      if (err) {
        console.log(err)
        return res.status(500).send('收藏内容加载失败')
      }
      res.render('savedItems.ejs', {
        // 单独传递用户名下的收藏文章数组
        savedArticles: currentUser.savedArticles,
        user: currentUser
      })
    })
})

2. 调整EJS视图渲染逻辑 #

此时视图接收到的savedArticles变量，就是已经完成populate的Article对象数组，循环时直接访问单个数组项的字段即可：

<% for(let i=0; i < savedArticles.length; i++) { %>
  <article class="saved-item">
    <a href="/articles/<%= savedArticles[i]._id %>">
      <h2><%= savedArticles[i].title %></h2>
      <p>创作人员：<%= savedArticles[i].director %></p>
      <p>发布年份：<%= savedArticles[i].year %></p>
      <% if(savedArticles[i].coverImage) { %>
        <img src="<%= savedArticles[i].coverImage %>" alt="<%= savedArticles[i].title %> 封面图">
      <% } %>
    </a>
  </article>
<% } %>

populate() 核心使用规则 #

• 第一个入参为需要执行关联填充的字段名，必须与Schema中配置了ref关联规则的字段名完全匹配
• 第二个可选入参为关联文档的返回字段白名单，多字段以空格分隔；不传该参数时默认返回关联文档的全部业务字段
• 关联查询生效的前提是，用户文档中savedArticles存储的ObjectId值，与Article模型对应集合的文档主键值完全一致，否则populate会返回空数组

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