Node.js ECONNRESET错误排查：如何定位代码行及获取更多信息？

错误含义 #

这个TypeError: terminated是由底层的ECONNRESET错误引发的：

• ECONNRESET表示你的Node.js程序与目标API服务器的网络连接在数据传输过程中被对方主动重置，可能的原因包括服务器超时、过载、网络波动，或者请求不符合服务器要求被强制断开。
• 上层的terminated错误只是Node.js内置fetch的底层库（undici）在连接中断时抛出的封装错误。

定位代码行与排查方法 #

1. 给所有fetch请求添加带上下文的错误捕获 #

给每个fetch调用包裹try/catch，在异常中打印请求的关键信息和完整调用栈，直接定位出错的请求：

async function fetchData(url, data) {
  try {
    const response = await fetch(url, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify(data)
    });
    return await response.json();
  } catch (err) {
    // 打印请求上下文，快速定位哪个请求出错
    console.error(`[请求失败] URL: ${url}, 参数: ${JSON.stringify(data)}`);
    // 生成包含自定义上下文的错误栈
    const customErr = new Error(`请求${url}时连接中断`);
    customErr.cause = err;
    console.error(customErr.stack);
    throw customErr;
  }
}

2. 启用Node.js的详细调用栈输出 #

运行脚本时添加--trace-warnings参数，强制打印完整的调用链路，包括你自己代码的调用位置：

node --trace-warnings your-script.js

这样输出的调用栈会显示错误是从你代码的哪一行触发的，而不是只停留在undici的内部代码。

3. 隔离排查范围 #

这个错误来自undici库（Node.js fetch的底层实现），和数据库操作无关，可以直接把排查重点放在所有API请求上：

• 临时注释掉数据库操作代码，单独运行fetch请求，确认错误来源；
• 逐一测试每个fetch请求，找出触发错误的具体请求。

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