Express.js中res.app.render使用await无效问题求助

问题场景 #

需要生成多份PDF文件并添加至邮件附件，但在Express.js中使用await调用res.app.render时异步执行顺序混乱，无法按预期完成流程。

相关代码 #

route.get('/:id/receipts', async function (req, res) {
   ...
   let attachments = [];
   for await(let item of items){
      res.view.item = item;
      console.log(1)
      await res.app.render('pdfs/receipt', res.view, async function(err, html){
         console.log(2)
         if (err) return res.end(err.stack)
         return await pdf.create(html).toBuffer(async function(err, buffer){
            console.log(3)
            attachments.push({
               content: buffer,
               filename: 'receipt.pdf',
           })
         });
      });
   }
   console.log(4)
   ...
})

预期输出 #

1
2
3
4

实际输出 #

1
4
2
3

问题原因 #

1. res.app.render是回调式API：它本身不返回Promise，外层的await无法等待其回调执行完成，会直接跳过进入后续代码，导致先输出1后立刻输出4。
2. 内部async回调无法被外层await捕获：即使在回调中使用async/await，也无法让外层的await感知到异步操作的完成，流程顺序完全失控。

解决方案 #

将回调式的API封装为Promise，通过await正确控制异步执行顺序。

修改后的代码 #

route.get('/:id/receipts', async function (req, res) {
   ...
   let attachments = [];

   // 把res.app.render封装为Promise
   const renderToHtml = (viewPath, viewData) => {
     return new Promise((resolve, reject) => {
       res.app.render(viewPath, viewData, (err, html) => {
         if (err) reject(err);
         else resolve(html);
       });
     });
   };

   // 把pdf.toBuffer封装为Promise
   const htmlToPdfBuffer = (html) => {
     return new Promise((resolve, reject) => {
       pdf.create(html).toBuffer((err, buffer) => {
         if (err) reject(err);
         else resolve(buffer);
       });
     });
   };

   // 依次处理每个item，确保顺序执行
   for (let item of items) {
     res.view.item = item;
     console.log(1);
     try {
       const html = await renderToHtml('pdfs/receipt', res.view);
       console.log(2);
       const buffer = await htmlToPdfBuffer(html);
       console.log(3);
       attachments.push({
         content: buffer,
         filename: `receipt-${item.id}.pdf`, // 建议给每个PDF加唯一标识避免重名
       });
     } catch (err) {
       return res.end(err.stack);
     }
   }
   console.log(4);
   ...
})

关键改动说明 #

• 封装回调API为Promise，让await能正确等待异步操作完成。
• 去掉不必要的for await...of（items是同步数组，无需异步迭代），改用普通for循环配合await，确保每个PDF生成流程完成后再处理下一个。
• 添加统一错误捕获，避免单个PDF生成失败导致整个流程崩溃。
• 给PDF文件名添加唯一标识，防止附件重名覆盖。

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