Node.js结合Mongoose如何获取多查询结果传入EJS渲染避免异步报错

你遇到的报错本质是路由内的res.render调用没有等待所有Mongoose异步查询执行完成，和Mongoose版本、exec方法本身无关。

之所以会出现“服务器重启首次访问报错、隔半秒刷新就正常”的现象，是因为最初的代码把res.render放在了查询逻辑的外层同步执行：

• 首次请求时，数据库缓存为空，嵌套两层的查询链路需要更长耗时，brandsToBeSent、postsToBeSent还没完成赋值，渲染就已经触发了，因此传入模板的变量为undefined
• 隔几秒刷新时，之前发起的查询已经跑完、结果存在数据库缓存里，查询耗时大幅缩短，刚好能赶上渲染时机，页面就会显示正常

之前尝试用exec()和.then()没解决问题，大概率是写Promise链时没有把内部嵌套的查询结果透传出去，导致最外层的then执行时，内层的关联查询还在异步执行。

方案1：async/await（优先推荐） #

这种写法的异步执行逻辑和同步代码可读性完全一致，没有深层嵌套，是新手维护项目的最优选择。
注意点：

• 路由处理函数必须声明为async，才能在内部使用await等待查询完成
• 必须用try/catch包裹所有异步查询，捕获查询过程中的错误

对应的可直接复用的代码：

app.get('/', async (req, res) => {
  try {
    // 等待第一层查询：找到名称为Featured的分类文档
    const featuredCategory = await Category.findOne({ 
      categoryName: "Featured" 
    }).exec();
    // 等待第二层关联查询：根据分类内的categoryProducts字段查询关联的品牌数据
    const brandsToBeSent = await Brand.find({
      _id: { $in: featuredCategory?.categoryProducts || [] }
    }).exec();
    // 等待独立查询：获取全量品牌数据
    const postsToBeSent = await Brand.find({}).exec();

    // 所有查询执行完毕、变量赋值完成后，再触发模板渲染
    res.render("home", {
      featuredposts: brandsToBeSent,
      siteposts: postsToBeSent
    })
  } catch (error) {
    // 查询出错时返回错误页面，避免请求挂起
    res.status(500).render("error", { 
      message: "页面加载失败，请稍后重试", 
      error 
    })
  }
})

方案2：Promise.then() 链式调用 #

如果暂时不熟悉async/await的语法，可以用Promise.all将两个独立的查询任务包装成Promise实例，等所有任务完成后再触发渲染。
注意点：

• 嵌套两层的查询链路必须保证Promise链完整透传，也就是内层查询的结果必须return到外层，不能断链
• 必须在链的末尾加错误捕获

对应的代码：

app.get('/', (req, res) => {
  // 第一个任务：完整封装两层查询链路
  const featuredBrandsTask = Category.findOne({ categoryName: "Featured" }).exec()
    .then(featuredCategory => {
      // 必须return内层查询的Promise，否则外层会感知不到这个任务的执行状态
      return Brand.find({
        _id: { $in: featuredCategory?.categoryProducts || [] }
      }).exec()
    })
  // 第二个任务：全量品牌查询
  const allBrandsTask = Brand.find({}).exec()

  // 等待两个任务全部执行完成
  Promise.all([featuredBrandsTask, allBrandsTask])
    .then(([brandsToBeSent, postsToBeSent]) => {
      res.render("home", {
        featuredposts: brandsToBeSent,
        siteposts: postsToBeSent
      })
    })
    .catch(error => {
      res.status(500).render("error", { 
        message: "页面加载失败，请稍后重试", 
        error 
      })
    })
})

• 给查询统一加.exec()：虽然不加也能返回可等待的Promise，但加了之后的错误堆栈信息更完整，调试难度更低，也是Mongoose官方推荐的写法
• 做空值兜底：如果数据库中不存在categoryName为Featured的分类，featuredCategory会返回null，此时代码中加的featuredCategory?.categoryProducts || []会兜底返回空数组，传入EJS后不会触发undefined.forEach的报错
• 不要把渲染逻辑和异步查询的执行顺序搞反：无论用哪种异步写法，只要res.render的执行时机早于所有查询完成的时机，就一定会出现首次加载数据缺失的问题

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