Node.js高负载下Web应用高延迟排查：如何获取持续详细调试日志？

针对你遇到的高负载下延迟飙升问题，以下几种方法可以高效获取持续的详细调试输出，替代手动pause/cont的低效操作：

1. 用Node.js内置追踪生成全量执行日志 #

Node.js的--trace-event-categories参数可以捕获从V8引擎到Node.js异步操作的全量执行数据，直接输出到文件：

node --trace-event-categories v8,node.async_hooks,node.fs.async,node.net.async,node.timers app.js > full-debug.log 2>&1

• 不同trace-event-categories对应不同追踪维度：v8覆盖JS函数调用、GC；node.async_hooks追踪所有异步资源；node.fs.async/node.net.async聚焦文件、网络异步操作
• 2>&1将标准错误输出也重定向到日志文件，确保不遗漏任何调试信息

2. 注入Async Hooks记录所有异步操作时序 #

通过Node.js的async_hooks模块，你可以在应用中嵌入代码，自动记录每个异步资源的创建、执行、销毁过程，输出到文件：

const fs = require('fs');
const async_hooks = require('async_hooks');

// 打开日志文件，追加模式
const logStream = fs.createWriteStream('async-trace.log', { flags: 'a' });

const traceHook = async_hooks.createHook({
  init(asyncId, type, triggerAsyncId) {
    logStream.write(`[${new Date().toISOString()}] INIT | AsyncID: ${asyncId} | Type: ${type} | TriggerID: ${triggerAsyncId}\n`);
  },
  before(asyncId) {
    logStream.write(`[${new Date().toISOString()}] BEFORE | AsyncID: ${asyncId}\n`);
  },
  after(asyncId) {
    logStream.write(`[${new Date().toISOString()}] AFTER | AsyncID: ${asyncId}\n`);
  },
  destroy(asyncId) {
    logStream.write(`[${new Date().toISOString()}] DESTROY | AsyncID: ${asyncId}\n`);
  }
});

traceHook.enable();

// 启动你的Web应用
require('./your-app-entry.js');

运行这个脚本后，所有异步操作（比如数据库查询、HTTP请求、定时器）的执行时序都会被持续记录，方便定位阻塞点。

3. 周期性自动记录调用栈（替代手动pause） #

如果需要模拟手动pause时的调用栈输出，可以用定时任务周期性捕获当前执行栈并写入文件：

const fs = require('fs');
const logFile = fs.createWriteStream('callstack-trace.log', { flags: 'a' });

// 每100ms记录一次当前调用栈，可根据需求调整间隔
setInterval(() => {
  const stackTrace = new Error().stack;
  logFile.write(`=== ${new Date().toISOString()} ===\n${stackTrace}\n\n`);
}, 100);

// 启动应用
require('./your-app-entry.js');

这种方式可以持续获取应用运行中的执行位置快照，和你手动暂停得到的输出逻辑一致，且无需人工干预。

4. Chrome DevTools性能录制（可视化分析） #

如果需要更直观的瓶颈定位，结合--inspect和Chrome DevTools的性能录制功能：

1. 启动应用：node --inspect your-app-entry.js
2. 打开Chrome浏览器，访问chrome://inspect，点击"Configure"添加本地调试端口，然后连接到你的应用
3. 进入Performance面板，点击录制按钮，同时模拟高负载场景
4. 停止录制后，可直接在面板中分析长任务、GC停顿、事件循环阻塞点，也可以点击"Save profile"将数据导出为JSON文件留存分析

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