node.js进程卡死但cpu归零是事件循环彻底停滞，poll阶段空转无i/o、定时器或setimmediate可执行，导致vscode调试器因v8 inspector心跳超时断连，表现为断点不命中、debug console灰掉；诱因包括同步阻塞操作、未处理promise.reject、长循环等。
为什么 Node.js 进程卡死但 CPU 归零，VSCode 却没反应
这不是调试器断连，而是事件循环彻底停滞——poll 阶段空转、无 I/O 事件可处理，也无定时器或 setImmediate 待执行，进程进入“假活”状态。VSCode 的 js-debug 依赖 V8 Inspector 协议通信，一旦事件循环冻结，调试器心跳超时，自动断开连接，表现为“断点不命中、Debug Console 灰掉、进程看似在运行却无响应”。
- 典型现象：请求挂起超时，
console.log不输出，process.uptime()停止增长，kill -USR1 <pid></pid>无法触发堆快照 - 常见诱因：同步阻塞操作（如
fs.readFileSync）、未处理的Promise.reject沉默失败、while(true)或长循环未让出控制权 - 注意：
setTimeout和setInterval在事件循环冻结时不会触发——它们依赖 timers 阶段，而该阶段根本没机会进入
如何用 VSCode + 内置工具验证事件循环是否卡住
别等它彻底死透，要在僵死前抓到延迟毛刺。Node.js 提供了 process.nextTick 和 performance.now() 的组合探测法，配合 VSCode 的 Debug Console 实时观测：
- 在入口文件顶部插入监控代码：
const start = performance.now();<br>process.nextTick(() => {<br> const delta = performance.now() - start;<br> if (delta > 50) console.warn('Event loop delay:', delta, 'ms');<br>}); - 启动调试后，在 Debug Console 中手动执行
require('perf_hooks').performance.eventLoopUtilization()—— 返回对象中active值长期接近 0 表示无活跃任务 - 若需持续监控，直接运行
node --inspect-brk app.js，再用 Chrome DevTools 打开chrome://inspect→ “Record” 录制 10 秒，看主线程火焰图是否长时间空白
VSCode launch.json 中必须加的 event loop 监控配置
默认 launch.json 不暴露底层调度细节。要让调试器捕获事件循环异常，得主动启用 inspector 并预留诊断端口：
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
-
"runtimeArgs": ["--inspect-brk=9229", "--trace-event-categories", "v8,disabled-by-default-node"]——--trace-event-categories是关键，它开启 Node.js 内部事件追踪，包括loop、timer、idle等阶段标记 -
"env": {"NODE_OPTIONS": "--trace-events-enabled --trace-event-file=./tracing.json"}—— 将事件写入文件，可在 Chrome DevTools 的chrome://tracing中加载分析 - 避免使用
"autoAttachChildProcesses": true同时启用--inspect-brk，否则子进程会因端口冲突卡在等待附加状态
死锁定位时最容易忽略的两个盲区
多数人盯着 Promise 和 async/await，却漏掉更底层的陷阱：
-
process.binding('uv').handle类原生句柄泄漏：比如未关闭的net.Socket、tls.TLSSocket或自定义libuvhandle，它们会阻止事件循环退出，但不会报错；用lsof -p <pid></pid>查看 fd 数量是否持续上涨 - 第三方模块的 C++ 插件死锁：如某些 SQLite 或图像处理 binding，在同步调用中持有 OS mutex 并等待 JS 层回调——此时 V8 线程被挂起，整个事件循环冻结；这类问题在 VSCode 中无法设断点，必须靠
gdb attach <pid></pid>查看线程栈
事件循环不是黑盒，但它只对主动暴露自己状态的代码留出观察窗口。别指望自动告警，得靠你提前埋点、配好 trace、并知道在哪查 fd 和 native stack。
