wasm-pack生成的free()方法：调用时机、自动调用及未调用影响咨询

背景 #

用Rust编写代码并通过wasm-pack编译后，生成的.d.ts文件中PdfDoc类包含free()方法：

export class PdfDoc {
  free(): void;
  ...
}

PdfDoc实例最高可占用1GB内存，因此正确释放内存十分关键，以下是相关问题的解答：

1. 应在何时调用free()方法？ #

• 当你确定再也不会使用该PdfDoc实例时立即调用：
  • 完成PDF处理、已获取所有所需数据（如文本、页面内容）后
  • 前端组件销毁、页面路由切换，实例不再被引用时
  • 批量处理PDF场景中，每处理完一个实例就调用free()，避免内存堆积

2. 是否需要显式调用，还是会自动调用？ #

• 必须显式调用：
  • Rust侧分配的内存（如堆上的Box、Vec等）不受JavaScript垃圾回收器（GC）管理，JS GC只能回收Wasm绑定的JS对象，无法释放Rust侧的内存
  • free()是Rust暴露的接口，用于触发内部的内存释放逻辑（比如调用drop trait或手动释放内存），不调用的话Rust侧内存永远无法被回收

3. 如果从不调用这些方法会发生什么？ #

• 会导致严重内存泄漏：
  • Rust侧占用的大量内存无法释放，进程内存占用持续攀升
  • 当内存占用超出系统可用内存时，会引发浏览器标签页崩溃、Node.js进程被OOM（内存不足）终止
  • 长期运行的应用会出现性能下降、卡顿甚至完全崩溃的问题

内容的提问来源于stack exchange，提问作者Jeffrey Rennie