使用Axios时遭遇EPIPE错误且预期413响应的处理方案

问题原因 #

EPIPE错误触发的原因是：服务器返回413（请求实体过大）后直接关闭了连接，但客户端仍在尝试向已断开的连接写入数据。这个错误属于Node.js底层流的异步错误，没有被Axios的Promise链包裹，所以常规的try-catch无法拦截，导致程序崩溃。

解决方案 #

1. 优化上传方式（从根源减少错误） #

不要把大文件转成Base64塞进JSON请求体，这种做法会占用大量内存，还容易触发服务器的大小限制。改用FormData结合文件流上传，Axios能更合理地处理连接中断的情况：

import axios from "axios";
import { createReadStream } from "fs";
import FormData from "form-data";

export const debugEpipe = async (event) => {
  const formData = new FormData();
  // 用文件流替代Buffer读取，减少内存占用
  formData.append("attachments", createReadStream("./bigfakefile.pdf"), {
    filename: "bigfakefile.pdf",
    contentType: "application/pdf",
  });

  try {
    const response = await axios.post("/some-endpoint", formData, {
      headers: formData.getHeaders(), // 自动设置正确的Content-Type
      maxBodyLength: Infinity, // 允许大请求体
      maxContentLength: Infinity,
    });
  } catch (e) {
    if (e.response?.status === 413) {
      console.log("文件过大，服务器拒绝接收");
    } else {
      console.log("上传出错:", e.message);
    }
    await sleep(1000);
    console.log("错误处理完成，程序继续执行");
  }
};

2. 全局捕获底层错误（兜底方案） #

如果暂时无法修改上传逻辑，可以通过监听Node.js的全局事件捕获EPIPE错误，避免程序直接崩溃：

// 在应用启动阶段添加该监听
process.on("uncaughtException", (err) => {
  if (err.code === "EPIPE") {
    console.log("上传时连接被服务器关闭，已处理EPIPE错误");
    // 可在此添加自定义恢复逻辑
  } else {
    // 其他未捕获异常按原有逻辑处理
    console.error("未捕获异常:", err);
    process.exit(1);
  }
});

注意：全局事件监听要精准过滤错误，避免掩盖其他严重问题。

3. 升级Axios到最新版本 #

部分旧版本Axios没有把底层流错误封装进Promise的reject中，升级到v1.x及以上版本后，EPIPE错误可能会被自动转为可被try-catch捕获的Promise拒绝。

4. 提前校验文件大小 #

在上传前先检查文件大小，若超过服务器限制直接提示用户，避免触发后续错误：

export const debugEpipe = async (event) => {
  const maxAllowedSize = 10 * 1024 * 1024; // 假设服务器限制10MB
  const fileSize = event.fileSizeInMb * 1024 * 1024;

  if (fileSize > maxAllowedSize) {
    console.log("文件超过大小限制，请上传更小的文件");
    return;
  }

  // 后续上传逻辑...
};

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