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
相关产品推荐
相关产品推荐

