Optimise API calls 是一个面向开发者的性能优化技能文档,核心目标是找出并移除请求、任务或页面在调用外部与内部 API(第三方 HTTP API 与 SDK、自有服务等)时产生的浪费。它不提供现成代码或一键工具,而是一套可操作的排查与改造流程。
文档首先强调“先测量”。在阅读代码之前,应从平台日志获取各路由的生产 p50、p95 和请求量,请求量决定修复优先级;对单次请求,用 performance.now() 包裹出站调用或读取 trace,形成时间线,将每个调用归类为关键路径、并行但慢、或响应不需要。
第二步是映射每个调用的输入依赖,画出依赖图,图深度即理论最短关键路径。移动调用前需检查顺序写入与副作用、速率限制、连接池、一致性和错误行为等约束,这些是串行顺序可能正确的理由。
第三步是按占用关键路径的时间排序常见浪费模式,并给出识别与修复方法:独立 await 串行应改为 Promise.all;循环内 await 应改为批量并发并限制并发数;串行分页在能获知总数时并行读取其余页;跳过结果不需要的调用;去重同一查找;将日志、分析、邮件等响应不等待的工作移到响应之后;用批量接口替代多次小调用;在模块作用域复用客户端;提前启动调用;为调用添加超时;检查函数与数据库的区域距离;利用 ETag/Last-Modified 条件请求。剩余时间常来自单个慢上游,代码无法加速,应报告并列出缓存、换端点或询问提供方等选项。
第四步用 compare 脚本对旧代码和新代码在真实服务上以相同输入进行对比,脚本先各跑一次预热,再交替运行,输出 p50、p90 和加速比,并在结果不一致时失败。TypeScript 项目用 npx tsx 运行,需注意 CommonJS 与 ESM 的顶层 await 问题,以及 server-only 等导出条件的加载。
第五步要求保持响应和产品行为不变,运行现有测试,仅为新行为添加测试,在有意保持顺序处添加注释,并在 PR 中说明旧串行理由为何不再成立。最后以数字开头撰写报告,包含结果对比表、变更点、剩余慢调用和已检查但跳过的项。
适用场景包括后端 API 聚合、页面数据加载、作业编排等需要降低延迟的调用链优化。限制在于:文档为方法论,不提供具体实现;所有优化需基于真实测量;改变产品行为(如轮询间隔、分页大小)不属于本技能范围,应作为选项列出成本。