添加await后跳过后续代码行的Node.js异步问题排查

我已经折腾这个问题好几个小时了，还是没搞明白。下面这段代码里，要是在sharp(image).rotate(value).toBuffer()前面加await，后面的console.log好像就完全不执行了。但把await去掉，那行日志就能正常跑。

const promises = this.imagesToProcess.map(async (image) => {
  try {
    await sharp(image).rotate(value).toBuffer() // <-- 这里出问题
    console.log(this.terminalColors.green, `${image} [Rotate - Processed]`)  // <-- 只有移除await才会执行
  } catch (e) {
    console.error(e)
    this.errors.push(this.terminalColors.red, `Could not process file ${image} [Skipping]`)
  }
})

// 等待所有promise完成
Promise.all(promises)

我肯定是对异步编程的理解不到位，但就是绕不过来这个弯。补充下，sharp是Node.js的图片处理库，从它的index.d.ts能看到toBuffer()确实返回Promise：

/**
 * Write output to a Buffer. JPEG, PNG, WebP, AVIF, TIFF, GIF and RAW output are supported.
 * By default, the format will match the input image, except SVG input which becomes PNG output.
 * @param options resolve options
 * @param options.resolveWithObject Resolve the Promise with an Object containing data and info properties instead of resolving only with data.
 * @returns A promise that resolves with the Buffer data.
 */
toBuffer(options?: { resolveWithObject: false }): Promise<Buffer>;

问题根源 #

核心问题不是await本身，而是你没正确等待Promise.all(promises)完成，甚至可能程序在异步任务结束前就提前退出了：

1. map里的异步函数加await后，会返回一个处于Pending状态的Promise，Promise.all需要等待所有这些Promise完成，但你现在只是调用了Promise.all(promises)，却没加await或者用.then()处理，导致程序可能在所有图片处理完成前就结束了，自然看不到后续的日志。
2. 去掉await时，toBuffer()返回的Promise会在后台异步执行，而console.log会立刻同步执行，所以你能看到日志，但这时候图片处理可能还没完成，甚至失败了也不会被正确捕获。

解决方案 #

修改代码，确保等待所有异步任务完成：

// 把处理逻辑放在异步函数里
async function processImages() {
  const promises = this.imagesToProcess.map(async (image) => {
    try {
      await sharp(image).rotate(value).toBuffer()
      console.log(this.terminalColors.green, `${image} [Rotate - Processed]`)
    } catch (e) {
      console.error(e)
      this.errors.push(this.terminalColors.red, `Could not process file ${image} [Skipping]`)
    }
  })

  // 必须加await等待所有任务完成
  await Promise.all(promises)
}

// 调用函数并处理顶层错误
processImages().catch(err => console.error('批量处理出错:', err))

额外提醒 #

• 异步函数里的await是正确的用法，它会暂停当前函数直到Promise完成，确保图片处理完再打日志。
• 如果你的代码本身就在一个异步方法里（比如类的async方法），直接在Promise.all(promises)前加await就行，不用额外套函数。

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