Node.js Windows平台下fs模块内存泄漏问题分析与修复

问题背景

在Node.js v22.14.0版本中，Windows平台下发现了一个严重的内存泄漏问题。当使用fs.readFileSync()方法以UTF-8编码读取文件时，每次调用都会导致Node.js进程的RSS内存持续增长，而JavaScript堆内存使用量保持稳定。这一问题特别在使用Worker线程频繁加载脚本文件时尤为明显。

问题现象

开发者通过以下测试代码重现了该问题：

import { readFileSync } from 'node:fs';

const options = { encoding: 'utf-8' };
for (let i = 1; true; i++) {
  readFileSync('./empty.txt', options);
  if (i % 1000 === 0) {
    i = 0;
    gc();
  }
}

测试结果显示，尽管显式调用了垃圾回收，进程的RSS内存仍持续上升，而堆内存保持稳定。这表明内存泄漏发生在Node.js底层而非JavaScript引擎层面。

技术分析

深入分析Node.js源码后发现，问题根源在于node::fs::ReadFileUtf8函数的实现缺陷。该函数在Windows平台下的处理流程存在以下关键问题：

1. 路径缓冲区分配：调用uv_fs_open时，内部函数fs__capture_path会分配一个UTF-16编码的缓冲区来存储文件路径，该缓冲区指针保存在uv_fs_s.file.pathw字段中。

2. 文件描述符覆盖：当后续调用uv_fs_read时，会将文件描述符写入uv_fs_s.file.fd字段。由于pathw和fd共享同一内存空间（union类型），写入文件描述符会覆盖原有的路径缓冲区指针。

3. 内存泄漏：被覆盖的路径缓冲区指针丢失，导致分配的内存无法被释放，从而造成内存泄漏。

解决方案

核心修复方案是在uv_fs_open调用后立即清理请求对象，释放路径缓冲区。具体修改如下：

1. 在uv_fs_open调用后添加uv_fs_req_cleanup(&req)语句
2. 移除错误处理分支中冗余的清理调用
3. 确保在文件操作完成后正确释放所有资源

这一修复方案已通过测试验证，有效解决了内存泄漏问题且未引入明显副作用。

影响范围

该问题主要影响：

• Windows平台下使用UTF-8编码同步读取文件的场景
• 频繁加载脚本文件的Worker线程应用
• 长期运行的Node.js服务进程

最佳实践建议

为避免类似问题，开发者应注意：

1. 对于长期运行的服务，考虑使用文件描述符而非路径重复访问文件
2. 监控进程内存使用情况，特别是RSS内存变化
3. 及时更新Node.js版本以获取安全修复
4. 在高频文件操作场景下进行充分的内存测试

该问题的修复体现了Node.js社区对平台兼容性和内存安全的高度重视，也展示了开源协作在解决复杂技术问题中的价值。