Spring Boot升级至3.2.4后出现Connection Closed BEFORE Send Operation异常

• 排查客户端主动断开连接的场景
  该异常核心是服务器准备发送响应时，客户端已提前断开TCP连接。建议：

  • 在日志中追加请求ID、客户端IP、User-Agent、请求从开始到异常触发的时长，统计这类请求的共性特征（比如是否来自特定客户端、请求时长是否接近某个超时阈值）。
  • 检查前端/客户端的超时配置，是否存在设置过短的请求超时，导致在服务器流式响应未完成时主动断开连接；移动端场景还要考虑网络波动导致的连接中断。

• 核对Reactor Netty版本变更的默认行为
  Spring Boot 2.5对应Reactor Netty 1.0.x，3.2.4对应1.1.x，两个版本在连接管理、响应处理逻辑上有不少变更：

  • 检查server.reactor.netty.connection-timeout、server.reactor.netty.idle-timeout等核心超时配置的默认值是否在新版本中发生变化，是否需要根据业务场景调整。
  • 查看Reactor Netty 1.1.x的变更日志，重点关注连接回收、响应提交时机的相关改动，确认是否存在与当前业务不兼容的默认策略。

• 检查流式响应接口的实现逻辑
  异常关联到controllerPackage#stream流式接口，需重点排查：

  • 接口返回的Flux/Mono是否存在未处理的异常，导致响应流提前终止；是否正确处理了背压逻辑，避免因下游消费过慢触发连接关闭。
  • 给流式接口添加详细日志，记录Flux的订阅、取消、完成事件，定位是否存在服务器端主动终止响应流的情况。

• 验证基础设施层的超时配置
  即使基础设施未变更，升级后服务器响应时长可能变化，导致原有中间件超时配置不再适配：

  • 检查负载均衡器、反向代理（如Nginx）的proxy_read_timeout等配置，是否因超时时间过短导致中间件提前断开与后端的连接。
  • 确认防火墙、安全组是否存在连接超时限制，是否会主动切断长时间未传输数据的连接。

• 排查连接池的其他相关配置
  除reactor.netty.pool.maxConnections外，Reactor Netty连接池的其他参数可能影响连接生命周期：

  • 检查server.reactor.netty.pool.max-idle-time、server.reactor.netty.pool.max-life-time的配置值，是否存在连接被提前回收，导致发送响应时连接已关闭。
  • 开启Reactor Netty的DEBUG日志（配置logging.level.reactor.netty=DEBUG），查看连接的创建、使用、回收全流程，定位连接异常关闭的时机。

• 排查依赖冲突或第三方组件兼容性
  升级Spring Boot时，部分第三方依赖可能未同步升级，引发兼容性问题：

  • 用mvn dependency:tree或gradle dependencies检查依赖树，确认是否存在与Reactor Netty 1.1.x、Spring WebFlux 6.x不兼容的依赖版本。
  • 在测试环境逐步移除非核心第三方组件（如自定义拦截器、监控插件），验证问题是否消失，定位冲突来源。

• 复现问题并抓包分析

  • 在测试环境模拟生产流量，或用curl等工具主动在响应过程中断开连接，尝试复现异常。
  • 用Wireshark抓包分析TCP连接的关闭过程，确认是客户端、服务器还是中间设备主动发起的连接断开。

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