Node/Express生产环境下如何等待axios API调用完成再渲染页面

• 嵌套回调结构缺乏统一错误捕获链路，生产环境下外部API请求超时、网络波动时会出现响应提前结束、渲染逻辑异常，和开发环境无外网限速、请求低延迟的表现形成差异
• 跨作用域错误判断失效：在axios成功回调内判断外层Mongo查询的err值，属于跨作用域的无效判断，完全起不到错误捕获的作用
• 原代码循环赋值存在逻辑bug：循环内每次都重新声明变量覆盖外层的空lic数组，最终只会拿到最后一条license数据，没有正确收集全部条目
• 路由处理函数未定义next参数，Logbook计数查询出错时调用next(err)会直接抛出未捕获引用错误，触发Express默认异常处理流程，中断后续axios请求逻辑
• 生产环境Node服务、配套反向代理的请求超时阈值更短，一旦axios请求响应时间超过阈值，服务会直接返回已生成的响应内容，不会等待异步Promise完成

核心调整方向：将嵌套回调替换为async/await写法，统一全链路错误捕获，修正变量赋值bug，补充外部API超时配置，确保所有异步流程执行完成后再触发页面渲染。

修正后的代码如下：

router.get('/:id', middleware.isLoggedIn, async (req, res, next) => {
  // 统一捕获异步流程所有异常，避免未捕获错误中断请求
  try {
    const perPage = 9
    const page = parseInt(req.params.page) || 1

    // 查询关联用户信息
    const foundUser = await User.findById(req.params.id).populate({
      path: 'log',
      options: {
        sort: { date: -1 },
        limit: 8,
        skip: (perPage * page) - perPage
      }
    }).exec()

    if (!foundUser) {
      req.flash('error', 'Something went wrong. User not found.')
      return res.redirect('back')
    }

    // 查询日志总数
    const logCount = await Logbook.find({ author: req.user.id }).countDocuments().exec()

    // 请求外部FCC API，显式配置超时参数
    const fccRes = await axios.get(
      'http://data.fcc.gov/api/license-view/basicSearch/getLicenses',
      {
        params: {
          searchValue: foundUser.username,
          format: 'json'
        },
        timeout: 5000
      }
    )

    const resData = fccRes.data
    // 校验返回数据结构
    if (!resData?.Licenses?.License) {
      console.log('License data structure invalid')
      return res.redirect(`/profile/${foundUser.id}`)
    }

    // 修正原循环赋值bug，兼容单条/多条license返回格式
    const licenseRes = resData.Licenses.License
    const lic = Array.isArray(licenseRes) ? licenseRes : [licenseRes]

    // 所有异步逻辑执行完成后再渲染页面
    res.render('profile/index', {
      user: foundUser,
      json: lic,
      current: page,
      pages: Math.ceil(logCount / perPage),
      logCount: logCount
    })

  } catch (err) {
    // 错误统一交由Express错误中间件处理
    next(err)
  }
})

• 开发环境通常配置更长的请求超时阈值，本地调用外部API的网络延迟更低，axios请求能快速返回，不会触发响应提前结束的问题
• 生产环境反向代理默认会在30-60秒无响应时返回504状态码，若外部API响应慢于阈值，就会出现“不等axios调用完成就返回页面”的现象
• 原代码嵌套回调链没有统一的异常捕获，一旦中间某一步抛出未处理异常，Express会直接中断当前请求，不会等待后续的axios Promise执行完成

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