前端JavaScript控制接口并发的核心是维护固定大小执行池，新请求未满则执行，已满则排队等待；可手动实现、封装RequestLimiter类或使用p-limit库，需注意AbortController管理、错误隔离、实例隔离及超时配置。
在前端用 JavaScript 控制接口请求的并发数，核心思路是：**维护一个固定大小的“执行池”，新请求进来时，若池子未满则立即执行；若已满，则排队等待空位释放后再执行**。不依赖后端或第三方库，纯 JS 即可实现。
手动实现简易并发控制器
用一个数组管理当前正在运行的 Promise，配合 async/await 和队列机制：
- 定义最大并发数（如 max = 3）
- 用 running 数组记录进行中的请求 Promise
- 每次发起请求前，检查 running.length < max；不满则直接 push 并 await；满则先 await Promise.race(running) 等最快的一个结束，再加入新请求
- 为避免 race 后无法区分哪个结束，更稳妥做法是用 Promise.allSettled 或封装一个带清理逻辑的执行器
使用类封装并发控制逻辑
推荐封装成可复用的 RequestLimiter 类：
PigX UI 前端开发
下载
PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。
- 构造时传入 maxConcurrent（如 5）
- 提供 add(requestFn) 方法，接收一个返回 Promise 的函数（如
() => fetch('/api/user/1')） - 内部维护 queue（待执行队列）和 running（运行中 Promise 数组）
- 每次 add 后自动触发调度：若还有空位且队列非空，就取出一个执行，并在它 resolve/reject 后再次调度
借助第三方库（轻量可靠）
如果项目允许引入小工具库，p-limit 是最常用选择：
立即学习“Java免费学习笔记（深入）”；
- 安装：
npm install p-limit - 用法简洁：
import pLimit from 'p-limit';<br>const limit = pLimit(3); // 最大并发 3<br><br>const requests = urls.map(url =><br> limit(() => fetch(url).then(r => r.json()))<br>);<br><br>const results = await Promise.all(requests);
- 它自动处理排队、错误传递、取消传播（需配合 AbortController）等边界情况
注意事项与常见坑
实际使用中要注意几个关键点：
- AbortController 需单独管理：p-limit 或手动控制器默认不支持中断，如需取消，得在外层创建 controller，并在 requestFn 中传入 signal
- 错误不能阻塞后续请求：务必在每个请求中 catch 错误，或用 Promise.allSettled 收集结果，否则一个 reject 会让整个 Promise.all 失败
- 避免全局共享同一个限流器：不同业务模块（如搜索 + 列表加载）应使用独立实例，防止互相干扰
- 超时控制建议放在请求层：并发控制只管“同时跑几个”，超时应由 fetch 或 axios 的 timeout 配置承担
