event-loop-blocked

Node.js 事件循环阻塞

现象

Node.js 服务健康检查超时、接口延迟抖动，但 CPU 可能不高；日志时间戳跳跃，定时器延迟，Prometheus 的 event loop lag 指标升高。

快速定位

node --prof app.js
node --prof-process isolate-*.log > profile.txt

使用 clinic：

npx clinic doctor -- node app.js
npx clinic flame -- node app.js

监控 event loop lag：

const { monitorEventLoopDelay } = require('perf_hooks')
const h = monitorEventLoopDelay({ resolution: 20 })
h.enable()
setInterval(() => console.log(h.mean / 1e6, h.max / 1e6), 5000)

常见根因

• 同步 CPU 密集任务（大 JSON、加密、图像处理）占用事件循环。
• 同步文件 IO 或 fs.readFileSync。
• 正则回溯、无限循环或大数组排序。
• 大量同步日志写入。
• 第三方库内部执行阻塞操作。
• 单进程承载过多并发连接。

修复

• 把 CPU 密集任务放到 worker_threads 或独立服务。
• 使用异步 IO，避免 *Sync 调用。
• 限制请求体大小和正则复杂度。
• 使用流式处理和大文件分片。
• 多实例/多进程分摊负载。
• 持续监控 event loop lag 并设置告警。

相关命令

• node --prof — V8 profiler
• clinic — 性能诊断
• 0x — 火焰图
• pm2 — 多进程管理