Node.js undici 库中 fetch 请求导致进程崩溃问题分析

问题背景

近期在 Node.js 23.1.0 版本中，部分开发者报告使用内置的 fetch API 时偶尔会出现整个 Node 进程崩溃的情况。这个问题在 Node.js 22.9.0 及以下版本中未曾出现，但在升级到 23.1.0 后开始发生，且持续存在于 23.3.0 版本中。

错误现象

当问题发生时，进程会抛出未捕获的异常并终止运行，错误堆栈显示以下关键信息：

TypeError: terminated
    at Fetch.onAborted
    at Fetch.emit
    at Fetch.terminate
    at Object.onError
    at Request.onError
    at Object.errorRequest
    at TLSSocket.<anonymous>

错误根源被标记为 ECONNRESET（连接重置），这表明在 TLS 连接过程中出现了网络中断的情况。

技术分析

底层机制

这个问题实际上涉及到 Node.js 底层的几个关键组件：

1. undici：Node.js 内置的高性能 HTTP/1.1 客户端，fetch API 的底层实现
2. TLS 层：负责安全通信
3. 事件处理机制：Node.js 核心的事件驱动架构

问题本质

当 TLS 连接意外中断（如收到 ECONNRESET）时，undici 内部会触发错误事件。在 Node.js 23.x 版本中，这些错误事件如果没有被适当处理，会沿着事件链向上传播，最终导致未捕获异常，进而终止整个进程。

版本差异

在 Node.js 22.x 版本中，类似网络错误可能被更优雅地处理或内部消化。而 23.x 版本中对错误传播机制进行了调整，使得这类错误更容易"逃逸"到顶层。

解决方案

临时解决方案

开发者可以添加全局异常捕获来防止进程崩溃：

process.on('uncaughtException', (err) => {
  console.error('捕获到未处理的异常:', err);
  // 可根据错误类型决定是否继续运行
});

最佳实践

1. 资源清理：确保所有 fetch 请求都在 try-catch 块中，并正确处理异常
2. 超时设置：为 fetch 请求配置合理的超时时间
3. 重试机制：对于非关键性请求，实现自动重试逻辑
4. 监控告警：建立完善的错误监控系统，及时发现和处理类似问题

深入理解

这个问题实际上反映了 Node.js 中一个重要的设计哲学：错误应该被显式处理。与某些其他语言不同，Node.js 倾向于让错误浮出水面，而不是默默忽略。这种设计虽然可能导致一些"意外"崩溃，但长期来看有助于开发者写出更健壮的代码。

对于网络请求这类容易出现各种错误的操作，开发者需要特别注意错误边界。即使代码中已经使用了 try-catch，某些底层错误仍可能通过事件机制"逃逸"，这正是本次问题的核心所在。

总结

Node.js 23.x 版本中对错误处理机制的调整使得开发者需要更加注意网络请求中的异常处理。虽然这带来了一些迁移成本，但从长远看有助于提高应用的稳定性。建议开发者：

1. 全面审查网络请求相关代码
2. 实现多层次的错误捕获机制
3. 考虑在关键服务中添加进程守护
4. 持续关注 Node.js 官方更新，及时获取修复补丁

通过理解底层机制并采取适当的防御性编程，可以有效地避免这类问题对生产环境造成影响。