java.io.IOException: Broken pipe \\ 你的主机中的软件中止了一个已建立的连接

最近收到一条线上的告警：

这个问题的根本原因是：网络连接已经被中断了，但程序还在尝试进行通信。通常发生在使用 Java 进行网络通信（如 HTTP 请求、Socket 通信）时，一方主动关闭了连接，而另一方仍试图写入数据，就会抛出类似下面的异常：

• Windows 下通常是：

  java.io.IOException: 你的主机中的软件中止了一个已建立的连接。

• Linux/macOS 下则表现为：

  java.io.IOException: Broken pipe

简单解释

我们可以把这当作你和朋友正在打电话：

• 你正说得起劲（Java 还在发送数据），

• 但对方已经挂掉电话了（连接被关闭），

• 你再说话（发数据）就没用了，结果系统提示你：“对方已经挂了，不要再说了”。

一个常见场景举例

比如：

• 前端设置了 20 秒的超时时间

• 后端某个接口处理时间达到了 30 秒

• 那么前端会在 20 秒后自动断开连接

• 后端在第 30 秒尝试返回响应，连接却已经不存在了，就会抛出 IOException

你可以用浏览器手动发起一个 GET 请求，再在请求未返回前关闭网页或刷新页面，就能复现这个错误。

怎么解决？

当你清楚了这个错误的来源，其实处理起来就很明确了。

如果是偶发、非关键业务场景：

• 可以直接捕获该异常并记录日志，避免影响主流程。

try {
response.getWriter().write(data);
} catch (IOException e) {
log.warn("客户端连接已关闭，响应发送失败", e);
}

如果是关键业务接口，无法容忍失败：

则建议从以下几个方向优化：

• 前端延长超时时间，避免连接断开太早

• 优化后端接口性能，减少处理时间

• 将耗时操作改为异步处理，立即返回再通过回调或轮询通知结果

• 加入重试机制或结果缓存，避免用户操作失败

总结

如果这个错误发生频率很低，并且不影响业务逻辑，那就捕获并记录日志即可；但如果它频繁出现或影响业务稳定性，就要从前后端的连接机制、处理时长和架构设计上做优化。