如何异步向数组推送数据：S3文件元数据获取时数组为空的问题

这是典型的JS异步回调时序问题：forEach循环为同步执行逻辑，循环内发起的s3.headObject请求全部为异步非阻塞调用，代码发起请求后会立即继续执行后续同步逻辑，走到循环外的console.log(metadata)代码行时，所有异步请求的回调尚未触发，自然无法读取到填充完成的数组。

当前Node.js环境原生支持async/await语法，搭配AWS SDK自带的Promise化调用能力，可以彻底规避嵌套回调导致的时序混乱，同时解决原代码中多次触发res.send的隐患。
核心修改点：

• 将路由处理函数改为async异步函数，支持通过await等待异步操作完成
• 所有S3 API调用替换为Promise形式，移除嵌套回调结构
• 收集所有获取元数据的请求Promise实例，通过Promise.all等待全部请求执行完成后，再统一读取数组做输出与响应

修改后的可运行代码：

exports.allMetadata = async (req, res) => {
  try {
    // 拉取桶内所有对象列表，保持原有环境变量读取逻辑
    const listParams = { Bucket: env.Bucket }
    const listData = await s3.listObjectsV2(listParams).promise()
    const contents = listData.Contents

    // 为每个对象生成元数据获取请求的Promise，组成数组
    const metadataTasks = contents.map(content => {
      const headParams = {
        Bucket: env.Bucket,
        Key: content.Key
      }
      return s3.headObject(headParams).promise()
    })

    // 等待所有元数据请求全部完成
    const allHeadResults = await Promise.all(metadataTasks)
    // 提取需要的元数据字段，此时数组已经完全填充
    const metadata = allHeadResults.map(item => item.Metadata)

    // 此处输出和响应都能拿到完整数据
    console.log(metadata)
    res.send(metadata)
  } catch (err) {
    // 统一捕获全链路错误，仅触发一次响应
    console.log(err, err.stack)
    res.send("error -> " + err)
  }
}

• 原代码在每个headObject的错误回调里直接调用res.send，一旦多个对象请求失败，会触发多次响应，导致Express抛出“响应头已发送”的错误，上述代码通过统一的外层错误捕获可以完全规避该问题。
• 如果S3桶内对象数量超过1000个，需要额外处理listObjectsV2的分页逻辑（通过ContinuationToken递归拉取全部对象），否则只能拿到第一页的对象列表。
• 不推荐在原回调结构上通过计数器的方式实现等待完成的逻辑，这类写法不仅代码冗余，还很容易在错误分支出现计数逻辑死锁的问题，async/await + Promise.all是当前场景下的最优实现。

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