Node.js环境下链式调用第三方API的执行时长优化咨询

核心前提：有前后依赖的API必须串行，这部分的时间损耗无法通过逻辑优化完全消除，只能尽量减少链路上的额外损耗

• 梳理依赖链路，拆分可并行请求
  先把所有需要调用的第三方API的依赖关系梳理清楚，只有强依赖前序接口返回参数的接口才需要放到串行链里，无依赖或者仅依赖同一个前序结果的接口可以用Promise.all并行发起，大幅减少总耗时。举个例子，比如调用完url1拿到结果后，url2和url3都只需要url1的返回值，互相不依赖，那总耗时就是url1耗时 + max(url2耗时, url3耗时)，远低于串行的三者相加。
• 替换高性能HTTP客户端，开启TCP连接复用
  Node.js原生fetch性能表现一般，且默认的连接复用配置不友好。推荐使用undici（Node.js官方维护的高性能HTTP/1.1客户端）或者axios，默认开启keep-alive复用TCP连接，省去每次请求的TCP三次握手、TLS握手耗时，第三方API调用的耗时可以降低30%以上。
• 封装通用请求工具，增加超时逻辑
  现有代码中每个请求都重复写了响应校验逻辑，额外增加了维护成本，而且没有超时控制，一旦某个第三方API响应超时会拉长整个链路的耗时。可以封装统一的请求方法，内置响应校验、超时控制（用AbortController实现）、错误打点，减少冗余代码的同时避免无意义的等待。
• 缓存公共依赖数据
  如果调用第三方API需要的鉴权token、公共配置等信息是所有用户注册请求共用的，不要每次请求都重新调用获取token的接口，把这类公共数据缓存到内存或者redis中，过期前直接复用，减少不必要的API调用。

优化后代码示例 #

const { fetch } = require('undici');
// 封装通用请求方法
const commonFetch = async (url, options = {}) => {
  // 5秒超时，可根据实际场景调整
  const controller = new AbortController();
  const timeout = setTimeout(() => controller.abort(), 5000);
  try {
    const response = await fetch(url, {
      signal: controller.signal,
      ...options
    });
    if (!response.ok) throw new Error(`HTTP error, status: ${response.status}`);
    return response.json();
  } finally {
    clearTimeout(timeout);
  }
}

// 业务逻辑
async function createThirdPartyRecords(userInfo) {
  try {
    // 必须串行的依赖请求
    const url1Res = await commonFetch('url1', { 
      method: 'POST', 
      body: JSON.stringify(userInfo),
      headers: { 'Content-Type': 'application/json' }
    });
    // 假设url2和url3都只依赖url1Res的参数，无互相依赖，并行调用
    const [url2Res, url3Res] = await Promise.all([
      commonFetch(`url2?param=${url1Res.requiredParam}`),
      commonFetch(`url3?param=${url1Res.requiredParam}`)
    ]);
    return { url1Res, url2Res, url3Res };
  } catch (err) {
    console.warn('调用失败：', err);
    throw err;
  }
}

注意：如果所有API确实存在强串行依赖（后一个必须等前一个的返回才能发起），那么总耗时的理论最小值就是所有API调用耗时的总和，上述方案能消除额外的冗余损耗，已经是该场景下的最优解

内容的提问来源于stack exchange，提问作者Harshu.19.97