You need to enable JavaScript to run this app. Node.js 批量发起API请求收集结果时返回空数组的异步问题
优惠活动
大模型
产品
解决方案
定价
更多

Node.js 批量发起API请求收集结果时返回空数组的异步问题

问题根因

核心是同步执行流和异步任务的时序错位。遍历单词数组时发起的fetch属于异步Promise任务,同步代码不会等待这些Promise完成,就直接执行了后续的打印、返回逻辑。此时所有fetch请求还处于pending状态,结果数组自然为空。
这类问题的常见触发场景是在forEach、普通for循环内部直接写异步请求逻辑,没有显式等待异步任务执行完成。

典型错误代码示例
app.get('/api', async (req, res) => {
  const wordList = ['apple', 'banana', 'cat'];
  const resultArr = [];

  // 错误:forEach不会等待内部的异步逻辑执行完成
  wordList.forEach(async (word) => {
    const params = new URLSearchParams({ query: word });
    const resp = await fetch(`https://example.com/query?${params}`);
    resultArr.push(await resp.json());
  });

  // 这行执行时,所有fetch请求还没返回
  console.log(resultArr); // 输出空数组[]
  res.json(resultArr);
});
可落地的解决方案

方案1:并发请求(优先推荐,性能更高)

使用Array.map把每个请求包装成独立的Promise,组成Promise数组后通过Promise.all等待全部任务完成,再拿到全量结果。

app.get('/api', async (req, res) => {
  const wordList = ['apple', 'banana', 'cat'];
  // 生成每个单词对应的请求Promise
  const requestPromises = wordList.map(async (word) => {
    const params = new URLSearchParams({ query: word });
    const resp = await fetch(`https://example.com/query?${params}`);
    if (!resp.ok) throw new Error(`单词${word}请求失败`);
    return resp.json();
  });

  try {
    // 等待所有请求完成,返回的结果顺序和原单词数组顺序完全一致
    const resultArr = await Promise.all(requestPromises);
    console.log(resultArr); // 正常输出全量结果
    res.json(resultArr);
  } catch (err) {
    res.status(500).json({ msg: err.message });
  }
});

方案2:串行请求(适合需要严格控制请求频率/顺序的场景)

如果外部API有频率限制,不支持高并发,可以用for...of循环配合await,逐次发起请求,等上一个请求完成再执行下一个。

app.get('/api', async (req, res) => {
  const wordList = ['apple', 'banana', 'cat'];
  const resultArr = [];

  // for...of可以配合await暂停外层循环,等待单个请求完成
  for (const word of wordList) {
    const params = new URLSearchParams({ query: word });
    const resp = await fetch(`https://example.com/query?${params}`);
    const data = await resp.json();
    resultArr.push(data);
  }

  console.log(resultArr); // 正常输出全量结果
  res.json(resultArr);
});
注意事项

如果请求量较大,外部API有接口频率限制,不建议直接使用Promise.all全量并发,可替换为Promise.allSettled兼容部分请求失败的场景,或者搭配并发控制能力限制同时发起的请求数,避免触发API的封禁规则。


内容的提问来源于stack exchange,提问作者Robert

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.23 01:54:02