Firebase JS SDK 中 Undici 内存泄漏问题分析与修复

问题背景

在 Firebase JavaScript SDK 的 10.13.0 版本中，发现了一个由底层 HTTP 客户端库 Undici 引起的内存泄漏问题。这个问题在 Node.js 20.16.0 及以上版本中表现得尤为明显，会导致应用程序内存使用量持续增长，严重影响系统稳定性。

技术细节

Undici 是 Node.js 官方维护的高性能 HTTP/1.1 客户端，Firebase SDK 使用它来处理网络请求。在特定条件下，Undici 5.x 版本中存在一个内存管理缺陷，当与 Node.js 20.16.0+ 配合使用时，会导致内存无法被正确回收。

这个问题的本质是 Undici 在处理某些 HTTP 请求时，未能正确释放与请求相关的内存资源，造成内存泄漏。随着应用程序运行时间的增长，内存消耗会持续增加，最终可能导致进程因内存不足而崩溃。

影响范围

该问题主要影响以下环境组合：

• 使用 Firebase JS SDK 10.13.0 版本
• 运行在 Node.js 20.16.0 及以上版本
• 特别是使用 Firebase Auth 等需要频繁进行网络请求的模块

解决方案

Firebase 团队迅速响应了这个问题，采取了以下措施：

1. 将 Undici 依赖从 5.x 版本升级到修复后的 6.19.7 版本
2. 这个新版本包含了针对内存泄漏问题的完整修复
3. 解决方案已合并到主分支，并将在下一个正式版本中发布

临时应对措施

对于暂时无法升级的用户，可以考虑以下临时解决方案：

1. 降级 Node.js 到 20.16.0 之前的版本
2. 限制 Firebase SDK 的网络请求频率
3. 监控应用内存使用情况，必要时重启进程

长期规划

Firebase 团队还透露了长期的技术路线：计划在未来版本中用原生的 fetch API 替代 Undici，这将从根本上避免类似问题的发生，同时也能简化依赖关系，提高 SDK 的稳定性。

总结

这个案例展示了开源生态系统中依赖管理的重要性。Firebase 团队对社区反馈的快速响应和问题解决，确保了开发者能够获得稳定可靠的工具。建议所有使用 Firebase JS SDK 的用户关注官方更新，及时升级到包含修复的版本。