解决：org.apache.catalina.connector.ClientAbortException: java.io.IOException: 断开的管道

文章目录

项目场景

jdk11
Spring Boot 2.x 项目，Tomcat容器
Nginx

问题描述

系统日志中，时不时会出现下面的异常信息：

org.apache.catalina.connector.ClientAbortException: java.io.IOException: 断开的管道
    at org.apache.catalina.connector.OutputBuffer.doFlush(OutputBuffer.java:310)
    at org.apache.catalina.connector.OutputBuffer.flush(OutputBuffer.java:273)
    at org.apache.catalina.connector.CoyoteOutputStream.flush(CoyoteOutputStream.java:118)
    at sun.nio.cs.StreamEncoder.implFlush(StreamEncoder.java:318)
    at sun.nio.cs.StreamEncoder.flush(StreamEncoder.java:153)
    at java.io.OutputStreamWriter.flush(OutputStreamWriter.java:251)
    at org.springframework.util.StreamUtils.copy(StreamUtils.java:148)
    at org.springframework.http.converter.StringHttpMessageConverter.writeInternal(StringHttpMessageConverter.java:126)
    ...

断开的管道，英文为：Broken pipe

原因分析

首先，需要理解什么是断开的管道？

简单来说，断开的管道意味着一台机器试图从管道中读取或写入数据，而管道另一端的机器已经死亡或终止。现在，由于连接已经关闭，应该建立新的连接以进一步传输数据，否则数据传输将停止。

它是如何发生的?
可能的原因有：

由于客户端在发送请求后，还没等服务器响应就断开了连接（可能是因为连接超时、网络原因(突然网断了)、或其他原因），导致服务端无返回通道
服务端配置导致：tomcat配置或者 nginx配置的超时时间小了
服务端nginx配置导致：连续两次过快的 post 请求就会出现 499 的情况，nginx 认为这是不安全的连接，主动断开了客户端的连接。参考如下：

nginx 中的 src/http/ngx_http_special_response.c 文件中对 499 状态码进行了定义：
ngx_string(ngx_http_error_494_page), /* 494, request header too large /
ngx_string(ngx_http_error_495_page), / 495, https certificate error /
ngx_string(ngx_http_error_496_page), / 496, https no certificate /
ngx_string(ngx_http_error_497_page), / 497, http to https /
ngx_string(ngx_http_error_404_page), / 498, canceled /
ngx_null_string, / 499, client has closed connection */

从注释上，我们可以看到 499 表示客户端主动断开连接。