Chrome请求wav文件后发RST导致SpringBoot Linux环境报Broken pipe异常

根因分析 #

• 该异常的核心触发原因是Chrome客户端接收完wav文件全部数据后，主动向服务端发送FIN、RST报文断开TCP连接，此时服务端仍在尝试向已关闭的连接写入数据、flush缓冲区或关闭输出流，Linux内核会直接返回EPIPE错误，最终转换为Java层的IOException: Broken pipe。
• 相同代码在Windows环境运行无异常，是因为Windows TCP栈对已关闭连接的写操作错误处理逻辑更宽容，不会向上层抛出该异常，属于不同操作系统内核的实现差异，和业务代码逻辑无关。

修复方案 #

1. 业务代码捕获忽略该类异常 #

在AiTtsController.tts方法中，对IO流复制、关闭的逻辑主动捕获客户端断开类异常即可，这类属于客户端正常行为，不需要当做错误处理：

try {
    IOUtils.copy(inputStream, response.getOutputStream());
    response.getOutputStream().flush();
} catch (ClientAbortException | IOException e) {
    if (e.getMessage() != null && e.getMessage().contains("Broken pipe")) {
        // 客户端主动断开，忽略即可，可按需打印debug级别的日志
        return;
    }
    // 其他IO异常正常抛出处理
    throw e;
} finally {
    // 关流逻辑也可以添加同类异常捕获，避免suppressed异常输出
    try {
        inputStream.close();
    } catch (Exception ignore) {}
    try {
        response.getOutputStream().close();
    } catch (Exception ignore) {}
}

2. 补全正确的响应头 #

返回wav响应时务必设置正确的Content-Length头，值为音频文件的实际字节长度，Chrome收到匹配Content-Length的数据后会正常完成四次挥手，大概率不会主动发送RST报文中断连接：

response.setContentType("audio/wav");
response.setContentLengthLong(wavByteLength); // 填入wav文件实际字节大小
// 可选配置优化客户端播放行为
response.setHeader("Content-Disposition", "inline; filename=audio.wav");
response.setHeader("Cache-Control", "public, max-age=31536000");

3. 全局配置屏蔽不必要的异常堆栈打印 #

如果不想在每个音频类接口单独处理，可以通过SpringBoot全局异常处理器统一捕获ClientAbortException，不打印错误堆栈，避免日志刷屏：

@RestControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(ClientAbortException.class)
    public void handleClientAbort(ClientAbortException e) {
        if (e.getCause() != null && e.getCause().getMessage().contains("Broken pipe")) {
            // 仅按需打印debug日志即可
            return;
        }
        log.error("客户端请求异常", e);
    }
}

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