Node扩展如何内存管理

在 Node.js 里，“Node 扩展”通常指 C/C++ Addon（原生扩展，如 .node 模块），也可能指 Electron 主进程的 Node 扩展。内存管理这块，核心区别在于：JS 层由 V8 自动 GC，C++ 层要你自己管，而且 JS 和 C++ 之间还有“桥接内存”。

下面按层次说清楚。

一、Node 扩展里的两类内存

1. JS 内存（V8 管理）

• 普通 {}、数组、字符串
• 由 V8 垃圾回收自动管理
• C++ 扩展不要直接 free JS 对象

2. C++ 原生内存（你自己管理）

• new / malloc
• std::vector、char*、Buffer 底层数据
• 必须手动 delete / free
• 泄漏就会一直占用到进程退出

二、C++ 扩展中常见的内存管理点

1. 不要返回裸指针给 JS

❌ 错误示例：

int* p = new int(10);
// 返回给 JS，没人帮你 delete

✅ 正确方式：

• 用 Napi::External
• 或 Napi::Buffer
• 或封装成对象并绑定析构

2. 使用 Napi::External（手动管理）

Napi::External<int> ext = Napi::External<int>::New(
  env,
  new int(42),
  [](Napi::Env, int* data) {
    delete data;
  }
);

• JS 拿到 external
• JS 被 GC 时，C++ 析构函数执行

3. Buffer 的内存（最常见坑）

情况 A：Buffer 由 JS 拥有

Napi::Buffer<char> buf = Napi::Buffer<char>::New(env, 1024);
// V8 管理内存

情况 B：Buffer 包装已有 C++ 内存

char* data = new char[1024];
Napi::Buffer<char> buf = Napi::Buffer<char>::New(
  env,
  data,
  1024,
  [](Napi::Env, char* d) {
    delete[] d;
  }
);

⚠️ 否则：

• Buffer 被 GC
• C++ 内存泄漏

4. 长期持有的引用（最容易泄漏）

static Napi::Reference<Napi::Object> ref;
ref = Napi::Persistent(obj);

• Persistent 会让对象不被 GC
• 不用时必须：

ref.Reset();

三、JS ↔ C++ 生命周期问题

典型问题

• C++ 对象还在用，JS 已 GC
• JS 还引用，C++ 已 delete（崩溃）

解决原则

✅ 谁创建，谁负责释放
✅ 跨边界对象必须有明确 owner
✅ 用 Finalizer（析构回调）而不是定时清理

四、常见内存问题 & 排查

1. 内存只涨不跌

可能原因：

• Persistent 没释放
• External 没写 destructor
• EventListener 没 remove

2. 崩溃（use-after-free）

• JS 还持有 Buffer
• C++ 已 delete

3. 工具

• --trace-gc
• process.memoryUsage()
• heapdump（JS 层）
• Valgrind / AddressSanitizer（C++ 层）

五、Electron / Node 扩展额外注意

• 主进程 & 渲染进程内存隔离
• Addon 不能跨进程共享 C++ 指针
• 渲染进程崩溃不会影响主进程内存

六、一句话总结

Node 扩展的内存管理 = V8 自动 GC + C++ 手动管理 + 明确的跨语言所有权

如果你愿意，可以告诉我：

• 用的是 N-API / NAN / node-addon-api
• 是否涉及 Buffer / Worker / Electron
• 是“写扩展”还是“排查泄漏”

我可以直接给你对应模板代码或排查清单。