如何在Express接口内精准计算并返回API响应时间？

为什么Postman和服务器记录的时间差很大？ #

Postman显示的是端到端总耗时，包含DNS解析、TCP握手、网络传输、服务器处理、响应回传等所有环节的时间。而你在服务器控制台记录的是纯业务逻辑处理时间，两者统计维度完全不同，差异大是正常现象。我们要做的是精准计算服务器端处理该请求的实际耗时。

两种精准计算方案 #

方案1：仅计算业务逻辑处理耗时

如果只关心接口内部业务代码的执行时间，在处理函数开始和结束（res.json前）分别记录高精度时间戳即可：

import { Request, Response } from 'express';

app.post('/api', function (req: Request, res: Response) {
  // 记录请求进入处理函数的纳秒级时间戳
  const startTime = process.hrtime.bigint();

  // --- 你的业务逻辑代码（比如数据库查询、数据计算）---
  const data = { result: '业务处理完成' };

  // 计算耗时并转换为毫秒（保留2位小数）
  const endTime = process.hrtime.bigint();
  const responseTime = parseFloat((Number(endTime - startTime) / 1000000).toFixed(2));

  // 返回结果和耗时
  res.json({ responseTime, data });
});

方案2：计算完整服务器处理耗时（含响应发送）

如果需要统计从请求进入路由到响应完全发送给客户端的总耗时，可监听res.finish事件（响应发送完成时触发）。若要把该耗时返回给前端，推荐用路由级中间件（仅作用于当前接口，非全局）：

import { Request, Response, NextFunction } from 'express';

// 仅作用于单个接口的耗时统计中间件
const measureFullResponseTime = (req: Request, res: Response, next: NextFunction) => {
  const startTime = process.hrtime.bigint();

  res.on('finish', () => {
    const endTime = process.hrtime.bigint();
    const responseTime = parseFloat((Number(endTime - startTime) / 1000000).toFixed(2));
    // 把耗时存入res.locals供后续处理函数使用
    res.locals.fullResponseTime = responseTime;
  });

  next();
};

// 给目标接口挂载中间件
app.post('/api', measureFullResponseTime, function (req: Request, res: Response) {
  // --- 你的业务逻辑代码 ---
  const data = { result: '业务处理完成' };

  // 返回完整服务器处理耗时和数据
  res.json({ responseTime: res.locals.fullResponseTime, data });
});

关键注意事项 #

• 用process.hrtime.bigint()而非Date.now()：前者提供纳秒级精度，对小于100ms的短耗时统计更精准；后者仅能到毫秒级，误差较大。
• 无需纠结与Postman时间一致：两者统计维度不同，服务器端的耗时才是你需要关注的接口实际处理效率指标。

内容的提问来源于stack exchange，提问作者Reza Ghorbani