如何确认Koa.js框架下NodeJS服务端响应的实际发出时间？

关于ctx.body赋值后打日志的准确性说明 #

该时间点统计是不准确的：给ctx.body赋值仅代表响应内容被挂载到Koa上下文，此时数据还未写入系统网络栈，更未从网卡发出，时间差会受事件循环调度、响应体大小、流缓冲区配置影响，不能作为Node进程实际发出响应的时间。

各时间节点精准捕获方式 #

1. Node.js进程响应发出时间 #

最准确的统计方式是监听HTTP响应的finish事件，该事件会在响应完全写入系统内核网络栈时触发，可通过Koa全局中间件实现：

// 放在所有业务中间件/路由之前注册
app.use(async (ctx, next) => {
  const reqStartTime = Date.now()
  await next()
  // 响应完全提交到网络栈时触发回调
  ctx.res.on('finish', () => {
    const processSendTime = Date.now()
    console.log(`请求路径${ctx.path} | 进程发出响应时间: ${processSendTime} | 服务端总处理耗时: ${processSendTime - reqStartTime}ms`)
    // 可写入自定义响应头，方便客户端直接拉取计算链路耗时
    ctx.set('X-Process-Send-Timestamp', String(processSendTime))
  })
})

如果是流式大响应，可额外监听drain事件统计分块发送的时间节点。

2. 物理服务器出口时间 #

即网卡实际将响应数据包发出的时间，两种常用统计方式：

• 服务器本地抓包：用tcpdump过滤对应端口和客户端IP的流量，输出的时间即为内核层面的网卡实际发送时间，精度可达微秒，命令示例：

  tcpdump -i any tcp port 你的服务监听端口 and host 测试客户端公网IP -tttt
  

• 云服务器可直接用VPC流日志功能，查询对应流量的出站时间，无需自行抓包。

正常情况下进程finish时间与服务器出口时间差在1ms以内，如果差值过大，需排查服务器内核网络栈拥塞、出站QoS限流、防火墙规则等问题。

3. 客户端浏览器接收时间 #

可直接调用浏览器原生Performance API获取精准时间：

// 客户端页面执行代码
window.addEventListener('load', () => {
  // 页面导航的性能数据
  const navPerf = performance.getEntriesByType('navigation')[0]
  // 浏览器收到第一个响应字节的时间
  const firstByteTime = navPerf.responseStart
  // 浏览器收到完整响应的时间
  const fullReceiveTime = navPerf.responseEnd
  // 读取自定义响应头的进程发出时间，直接计算链路总耗时
  const resourcePerf = performance.getEntriesByType('resource').find(item => item.name === location.href)
  const processSendTime = Number(resourcePerf.responseHeaders.get('X-Process-Send-Timestamp'))
  console.log('网络链路总耗时：', fullReceiveTime - processSendTime, 'ms')
})

也可直接查看浏览器开发者工具网络面板的「时间」标签，对应响应的「等待服务器响应」+「内容下载」时间之和，就是从请求发出到响应完全接收的总耗时。

延迟根因定位逻辑 #

• 若进程发出时间与服务器出口时间差值过大：问题出在服务器本身网络配置/负载，排查CPU、内存占用，出站限流规则，内核网络参数配置
• 若服务器出口时间与客户端接收时间差值过大：问题出在公网链路，排查路由节点延迟、带宽拥塞、CDN回源策略、运营商链路故障等

内容的提问来源于stack exchange，提问作者Temp O'rary