Node.js 单线程模型下，事件循环延迟通常由同步代码或 CPU 密集型任务占用主线程导致，而非异步 IO 阻塞。perf_hooks 模块能有效监控延迟数值，但无法直接输出堆栈信息，需结合日志定位具体代码。

先说结论：perf_hooks 适合用于生产环境持续观测延迟趋势，定位具体阻塞代码需结合日志时间戳或 profiling 工具。

• 先定位：开启 monitorEventLoopDelay 监控
• 先做：记录高延迟时间段的操作日志
• 再验证：优化后观察延迟数值是否回落

核心原理与局限

perf_hooks 通过比较事件循环预期执行时间与实际执行时间的差值来计算延迟。需注意：它只能告诉你“慢了”，不能直接告诉你“哪行代码慢”。

实操：监控与模拟阻塞

以下代码演示如何启动监控，并故意制造阻塞以观察数据变化：

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

// 1. 启动监控
const delayMonitor = monitorEventLoopDelay({ resolution: 10 });
delayMonitor.start();

// 2. 模拟 CPU 密集型任务（故意阻塞）
function blockEventLoop() {
    const start = Date.now();
    while (Date.now() - start < 500); // 阻塞 500ms
}

// 3. 定期读取数据
setInterval(() => {
    const histogram = delayMonitor.histogram;
    console.log('P99 Delay:', histogram.percentile(99), 'ms');
    // 模拟阻塞后再次观察
    if (Math.random() > 0.8) blockEventLoop();
}, 1000);

数据分析与日志关联

单纯看延迟数值无法定位代码，需将延迟峰值与业务日志时间戳对齐：

const logger = require('your-logger');

setInterval(() => {
    const histogram = delayMonitor.histogram;
    const p99 = histogram.percentile(99);
    // 设定阈值告警
    if (p99 > 100) {
        logger.warn('EventLoopDelay High', {
            timestamp: Date.now(),
            p99: p99,
            max: histogram.max
        });
    }
}, 5000);

排查时，搜索日志中 delay 峰值时间点附近的操作，通常是同步计算、大 JSON 序列化或同步文件读写。

常见坑与排查

• GC Pause 干扰：垃圾回收也会造成事件循环暂停，需结合 `--trace-gc` 参数区分。
• 监控开销：不要高频打印 histogram 数据，建议聚合后上报。
• 版本兼容：确保 Node.js 版本 >= v11.10.0，旧版本不支持此 API。
• 定位误区：不要期望 perf_hooks 输出堆栈，定位具体代码需配合 async_hooks 或 CPU Profiler。