如何测量Node.js事件场景API调用响应时间并开展性能测试

核心统计逻辑：计时起点放在API调用发起前的瞬间，终点为客户端监听器收到对应响应事件的时刻，采用Node.js内置高精度单调时钟计时，避免系统时间变动带来的统计误差。

基础单请求实现代码 #

适用于单次请求、串行测试的场景：

const { performance } = require('perf_hooks');

// 发起API前立刻记录起始时间戳
const reqStartTime = performance.now();

// 执行实际API调用
await yourApiCallMethod();

// 注册事件监听器
const responseHandler = async (event) => {
  // 收到事件第一时间计算耗时
  const totalCostMs = performance.now() - reqStartTime;
  console.log(`全链路响应耗时：${totalCostMs.toFixed(2)}ms`);
  console.log("result");

  // 单次响应对应单次请求的场景，收到结果后立刻移除监听器，避免重复触发、内存泄漏
  context.events.myEvent().off('data', responseHandler);

  // 性能测试可将耗时存入统计数组，后续计算平均值、分位值
  // metricsCollection.push(totalCostMs);
};
context.events.myEvent().on('data', responseHandler);

高并发压测场景适配 #

如果要做并发性能测试，单全局变量会出现请求计时串扰，需要给每个请求分配唯一ID，通过映射表匹配每个请求的起始时间：

const { performance } = require('perf_hooks');
// 存储各请求的起始时间，key为请求唯一ID
const reqStartRecord = new Map();

async function sendRequest(uniqueRequestId) {
  reqStartRecord.set(uniqueRequestId, performance.now());
  // 调用API时透传请求ID，要求服务端返回事件时携带同ID用于匹配
  await yourApiCallMethod(uniqueRequestId);
}

const globalEventHandler = async (event) => {
  const matchedReqId = event.requestId;
  if (!reqStartRecord.has(matchedReqId)) return;
  
  const totalCostMs = performance.now() - reqStartRecord.get(matchedReqId);
  console.log(`请求${matchedReqId}全链路响应耗时：${totalCostMs.toFixed(2)}ms`);
  // 统计完成后删除记录，避免内存持续膨胀
  reqStartRecord.delete(matchedReqId);
};
// 全局只需要注册一次监听器即可
context.events.myEvent().on('data', globalEventHandler);

关键注意事项 #

• 禁止将起始时间戳打在API调用的await之后，否则会漏掉API请求发送、网络传输、服务端处理的耗时，导致统计结果严重偏小。
• 优先使用perf_hooks提供的performance.now()计时，不要用Date.now()：前者为单调递增时钟，精度可达亚毫秒级，不受系统时间同步调整、用户手动改时间的影响，完全适配性能测试场景。
• 批量压测完成后，可以直接对收集到的耗时数组做排序，计算P50/P90/P95/P99等分位值，不需要依赖第三方统计库。
• 若需要覆盖异常场景，可额外添加API调用异常捕获、事件error监听，在错误分支同样计算耗时，区分正常/异常请求的性能表现。

内容的提问来源于stack exchange，提问作者ali akbari