如何利用 Map 的键名唯一性实现对并发 API 请求的“静态合并”逻辑-js教程-PHP中文网

利用map键名唯一性实现并发api请求的“静态合并”，即通过标准化请求参数生成唯一key，使多次并发调用共享同一promise实例，避免重复网络请求。

如何利用 map 的键名唯一性实现对并发 api 请求的“静态合并”逻辑

利用 Map 的键名唯一性实现并发 API 请求的“静态合并”，核心是把相同请求参数（或语义等价的请求）映射为同一个 key，让多次并发调用共享同一个 Promise 实例，避免重复发起网络请求。这不是运行时动态去重（如节流/防抖），而是基于请求标识的“缓存式合并”。

一、确定稳定且语义准确的请求 key

Key 必须满足：相同语义的请求生成相同 key，不同语义的请求生成不同 key。不能只拼接 URL，需考虑：

查询参数需标准化：对 query 对象排序后序列化（如使用 new URLSearchParams(obj).toString() 或 JSON.stringify(Object.fromEntries([...new URLSearchParams(q)].sort()))）
忽略非影响响应的字段：如 timestamp、requestId、traceId 等临时字段应剔除
区分 method 和 body（如 POST）：GET 请求 key 通常只需 URL + query；POST 若依赖 body，则需将 method + URL + normalizedBody 一起参与哈希（注意 body 可能是 stream 或未读取的 raw string，需提前规范化）

二、用 Map 缓存 Promise 实例而非结果

Map 存的是 key → Promise<t></t>，不是 key → T。这样能确保：

首次请求触发执行，后续并发请求直接 await 同一个 Promise
Promise settle 后自动从 Map 中清理（可选，但推荐在 finally 中 delete）
避免 race condition：不手动 new Promise，而是统一由第一个调用者创建并执行 fetch，其余复用

三、封装成可复用的请求合并函数

示例（TypeScript + fetch）：

const pendingRequests = new Map<string promise>>();

function makeMergedRequest<t>(
  key: string,
  fetcher: () => Promise<t>
): Promise<t> {
  if (pendingRequests.has(key)) {
    return pendingRequests.get(key)!;
  }

  const promise = fetcher()
    .finally(() => pendingRequests.delete(key));

  pendingRequests.set(key, promise);
  return promise;
}

// 使用时先生成 key
const key = generateRequestKey({
  url: '/api/user',
  method: 'GET',
  params: { id: 123 }
});

makeMergedRequest(key, () => fetch('/api/user?id=123').then(r => r.json()));
</t></t></t></string>