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);
}
如果是关键业务接口，无法容忍失败：
则建议从以下几个方向优化：
-
前端延长超时时间，避免连接断开太早
-
优化后端接口性能，减少处理时间
-
将耗时操作改为异步处理，立即返回再通过回调或轮询通知结果
-
加入重试机制或结果缓存，避免用户操作失败
总结
如果这个错误发生频率很低，并且不影响业务逻辑，那就捕获并记录日志即可；但如果它频繁出现或影响业务稳定性，就要从前后端的连接机制、处理时长和架构设计上做优化。