1 / 4概念
Runtime
Node.js 把 V8 的 JavaScript 执行、libuv 的事件循环与线程池、以及文件/网络/进程 API 拼成一个服务端运行时。判断标准不是“单线程所以慢”,而是哪些工作在主线程、哪些进了线程池、队列是否有上限、内存是否被正确释放。
1 概念
1.1 一句话定义
Node.js 是 V8(执行 JS、管理堆与 GC)+ libuv(事件循环、线程池、跨平台 I/O)+ Node 标准库(fs、net、http、stream 等)+ 模块系统组成的运行时。主 isolate 的 JS 回调都在主线程执行,阻塞 I/O 通过 libuv 的线程池或内核事件通知完成。
1.2 它解决什么问题
- 高并发 I/O:单线程事件循环 + 非阻塞 I/O,避免为每个连接创建线程。
- 统一语言:前后端共享 JavaScript/TypeScript 与类型。
- 跨平台:libuv 封装 epoll/kqueue/IOCP,Node API 在主流系统上行为一致。
- 流式处理:
stream与背压让大文件/大响应不必一次性进内存。
没有事件循环,Node 只是一个同步脚本解释器;不理解线程池和背压,高并发会变成高延迟和内存上涨。
1.3 不属于本页的内容
| 主题 | 去哪 |
|---|---|
| JS 值、闭包、模块、类型系统 | JavaScript / TypeScript Language Basics |
| 浏览器 DOM、渲染管线与 Web 存储 | Browser Environment |
| NestJS 模块、守卫与 DI | Backend Frameworks |
| 操作系统调度、虚拟内存、文件系统 | Operating Systems |
| HTTP/TLS/负载均衡 | Application Protocols |
1.4 关键术语
| 术语 | 含义 | 容易混淆的点 |
|---|---|---|
| 事件循环 | 反复取任务并执行回调的循环 | 不是“多线程” |
| 阶段(phase) | 事件循环的固定处理阶段 | 不是任务类型 |
| 宏任务 | setTimeout、setImmediate、I/O 回调 | 不是微任务 |
| 微任务 | Promise、queueMicrotask | 在阶段切换前清空 |
process.nextTick | 当前操作结束后、事件循环继续前的队列 | 优先级高于 Promise |
| 线程池 | libuv 的工作线程,默认 4 个 | 不处理所有 I/O |
| 句柄/请求 | libuv 的长期/一次性工作单元 | 不是 Promise |
| 背压 | 下游处理不过来时让上游减速 | 不是限流 |
| GC | V8 的垃圾回收 | 不是引用计数 |
| Worker | 独立 isolate + 消息传递 | 不共享 JS 堆 |
2 机制
2.1 心智模型
主线程只有一条 JS 执行栈,事件循环负责把回调送进来;libuv 在背后用内核事件通知(网络)或线程池(文件、DNS、加密、压缩)完成阻塞工作。任何同步 CPU 工作都会卡住整条栈,任何无界队列都会把内存变成延迟。
2.2 机制拆解
- 事件循环阶段:timers → pending callbacks → idle/prepare → poll → check(
setImmediate)→ close callbacks;每个阶段之间清空微任务和nextTick队列。 - 微任务/宏任务:一个宏任务执行完后,先清空
nextTick,再清空 Promise 微任务,然后才进入下一阶段;无限微任务会饿死 I/O 与定时器。 - 线程池:默认 4 个线程,服务
fs、dns.lookup、crypto(部分)、zlib等;网络 socket 走内核事件通知,不占线程池。 - 内存与 GC:V8 分新生代/老生代,采用 scavenge 与标记-清除/整理;Buffer 分配在外部内存;闭包、监听器、缓存和全局 Map 是常见泄漏源。
- 并发模型:
worker_threads提供独立 isolate 与消息传递;cluster启动多进程共享端口;child_process启动外部程序。 - 背压:
writable.write()返回false时要等drain;stream.pipeline()会自动处理错误与销毁;无界缓冲会把内存打满。
2.3 完整枚举
事件循环阶段(完整集合):
| 阶段 | 处理内容 | 典型回调 |
|---|---|---|
| timers | 到期的 setTimeout/setInterval | 定时器回调 |
| pending callbacks | 上一轮延迟的系统回调 | 部分 TCP 错误 |
| idle/prepare | 内部准备 | 库内部使用 |
| poll | 等待/执行 I/O 回调 | fs、net、http |
| check | setImmediate | 立即回调 |
| close callbacks | 关闭事件 | socket.on('close') |
异步原语:
| 原语 | 调度位置 | 适用 | 注意 |
|---|---|---|---|
| 回调 | 事件循环/I/O 完成 | 底层 API | 易回调地狱 |
| Promise | 微任务 | 组合异步 | 未处理拒绝 |
async/await | Promise 语法糖 | 顺序异步 | 忘记 await |
| EventEmitter | 同步触发 | 事件广播 | 监听器泄漏 |
| Stream | 事件 + 背压 | 大文件/网络 | 必须处理错误 |
| Worker | 独立线程 | CPU 密集 | 序列化成本 |
线程池常见使用者:
| API | 是否用线程池 | 说明 |
|---|---|---|
fs.readFile/writeFile | 是 | 大文件可用流 |
dns.lookup | 是 | dns.resolve* 走网络 |
crypto.pbkdf2/randomBytes | 部分是 | 取决于实现 |
zlib | 是 | 压缩/解压 |
net/http socket | 否 | 内核事件通知 |
2.4 关键数字与量级
| 指标 | 量级 | 说明 |
|---|---|---|
| 默认线程池 | 4 | UV_THREADPOOL_SIZE 可调,最大 1024 |
| 事件循环延迟 | 毫秒级 | 长任务会放大 |
| V8 堆上限 | 约 2–4 GB | 取决于版本与平台 |
| 默认 highWaterMark | 16–64 KB | 流缓冲阈值 |
| 常见 body parser 默认上限 | 约 100 KB | 可配置,不是 Node 核心限制 |
3 实践
3.1 最小示例
import {pipeline} from 'node:stream/promises';
import {createReadStream, createWriteStream} from 'node:fs';
// 1. 观察执行顺序:同步 → nextTick → Promise → 定时器/立即。
console.log('sync');
process.nextTick(() => console.log('nextTick'));
Promise.resolve().then(() => console.log('promise'));
setTimeout(() => console.log('timeout'), 0);
setImmediate(() => console.log('immediate'));
// 2. 背压:pipeline 负责 drain、错误与销毁,避免手工拼事件。
await pipeline(
createReadStream('input.log'),
createWriteStream('output.log'),
);
3.2 常用操作与参数
| 操作 | 命令 / API | 说明 |
|---|---|---|
| 查看事件循环延迟 | perf_hooks.monitorEventLoopDelay() | 直方图统计 |
| 查看内存 | process.memoryUsage() | heapUsed/rss/external |
| 调整线程池 | UV_THREADPOOL_SIZE=8 | 启动前设置 |
| 抓 CPU profile | node --cpu-prof app.js | 生成 .cpuprofile |
| 调试 | node --inspect | Chrome DevTools 连接 |
| 流式复制 | stream.pipeline() | 自动背压与清理 |
| CPU 密集 | worker_threads | 独立 isolate |
| 多进程 | cluster | 共享端口 |
| 取消 | AbortController | 传递取消信号 |
3.3 标准流程
- 先判断任务是 I/O 密集还是 CPU 密集;CPU 密集不要留在主线程。
- 用异步 API;禁止在请求路径使用同步文件/加密/压缩。
- 大文件/大响应走流,检查
write()返回值和drain。 - 限制并发:用队列/信号量,不要无界
Promise.all。 - 监控事件循环延迟、RSS、heapUsed 和线程池队列。
- 内存泄漏用 heap snapshot 对比,不要靠重启掩盖。
3.4 与相邻技术的组合
- JS 语言:Promise/async 的微任务语义决定回调顺序;闭包决定对象何时可回收。
- NestJS:请求处理跑在事件循环上,同步阻塞会拖慢所有请求。
- 操作系统:线程池、socket、文件描述符最终由内核调度;
epoll/kqueue是 poll 阶段的底层。 - 网络协议:HTTP keep-alive、流式响应和背压共同决定连接与内存。
3.5 选型维度
| 维度 | 取值 | 影响 |
|---|---|---|
| 任务类型 | I/O 密集 / CPU 密集 | 事件循环或 Worker |
| 并发模型 | 单进程 / cluster / worker | 隔离与共享成本 |
| 数据规模 | 小对象 / 大文件 | 缓冲或流 |
| 延迟目标 | 低 / 可排队 | 队列与背压策略 |
| 部署 | 长驻 / Serverless | 启动与冷启动 |
3.6 决策规则
- I/O 密集:单进程事件循环 + 异步 API,不要为每个请求开线程。
- CPU 密集:
worker_threads;需要进程隔离/复用多核:cluster或容器副本。 - 大文件:
pipeline+ 流;不要readFile后整体处理。 - 并发:有界队列 + 超时 + 取消;不要无界
Promise.all。 - 线程池:只有
fs/dns/crypto/zlib密集时才调大,调大不是免费。
3.7 替代方案对比
| 方案 | 优势 | 代价 | 适用 |
|---|---|---|---|
| 事件循环 | 轻量、高并发 I/O | 怕同步阻塞 | API、代理、实时服务 |
worker_threads | 共享进程、消息传递 | 序列化、内存翻倍 | CPU 密集 |
cluster | 多核、进程隔离 | 内存与端口管理 | 多核 HTTP 服务 |
child_process | 隔离、可跑外部程序 | 启动与 IPC 成本 | 工具链、隔离任务 |
| 缓冲 | 简单 | 内存峰值高 | 小响应 |
| 流 | 内存平稳、背压 | 实现复杂 | 大文件、大响应 |
3.8 何时不该用
- 纯 CPU 计算:不要放在主线程,用 Worker 或换运行时。
- 小脚本:不要引入 cluster/worker 的复杂度。
- 无界并发:不要把
Promise.all用在不可控输入上。 - 同步 API:不要在服务请求路径使用
readFileSync/pbkdf2Sync。 - 无背压的流:不要忽略
write()返回值。
4 边界
4.1 典型故障
| 症状 | 根因 | 处理 |
|---|---|---|
| 所有请求突然变慢 | 主线程被同步任务阻塞 | CPU profile,移入 Worker/拆分 |
| 文件操作排队 | 线程池被占满 | 调大池/减少并发/用流 |
| 内存持续上涨 | 监听器/缓存/闭包泄漏 | heap snapshot,移除监听 |
| 进程退出 | 未处理的 Promise 拒绝/异常 | unhandledRejection/uncaughtException 兜底 |
| 响应内存峰值高 | 忽略背压、整体缓冲 | pipeline/drain |
| 定时器不准 | 事件循环延迟 | 监控延迟,减少长任务 |
| 端口被占用 | 上一个进程未退出 | 查进程/换端口 |
| Worker 崩溃无日志 | 未监听 error/exit | 绑定错误处理 |
4.2 反模式
| 做法 | 后果 | 替代 |
|---|---|---|
| 请求路径用同步 I/O | 阻塞所有请求 | 异步 API/流 |
无界 Promise.all | 内存与下游压力失控 | 有界并发 |
| 全局缓存无上限 | 内存泄漏 | LRU/TTL |
库代码里 process.exit | 调用方无法清理 | 抛错/返回状态 |
忽略流的 error | 进程崩溃或挂起 | pipeline |
4.3 可观测信号
事件循环延迟直方图、CPU 使用率、RSS/heapUsed/external、GC 暂停、活跃句柄数、线程池队列、P99 延迟、未处理拒绝数。
4.4 安全 / 性能 / 一致性边界
- 单线程是正确性边界:共享可变状态不需要锁,但任何阻塞都会全局放大。
- 内存是硬边界:V8 堆 + Buffer 外部内存受容器限制,OOM 会直接杀进程。
- 背压是稳定性边界:无界缓冲最终会变成延迟或崩溃,不是“更快”。
- 隔离边界:不可信代码不要在主 isolate 执行,用 Worker/子进程/沙箱。