云环境Spring Boot应用偶发MongoDB SocketException异常无法复现咨询原因

异常触发核心原因 #

从日志最底层堆栈的java.net.SocketException: Broken pipe (Write failed)可以判断，异常是应用端持有的MongoDB数据库连接已经被服务端/中间网络主动断开，但应用端仍在尝试使用这个失效连接发送请求导致的。
本地开发环境无法复现的原因是：本地环境没有云环境专属的连接闲置回收、网络会话超时等配置，连接不会被无感知断开。异常偶发是因为只有请求刚好拿到连接池里已经失效的连接时才会触发，绝大多数请求分配到可用连接时不会报错。

常见触发场景 #

• 云MongoDB实例默认配置了闲置连接超时规则（多数云厂商Mongo默认30分钟无流量就自动断开空闲连接），K8s集群部署的场景下，Mongo Service、kube-proxy也可能配置了TCP会话超时，超时后会主动静默断开连接
• Spring Boot MongoDB客户端默认的连接池maxConnectionIdleTime配置大于服务端的闲置超时时间，导致连接池中长期存留已经被服务端回收的失效连接
• 云环境出现瞬时网络波动，导致存量TCP连接被重置
• MongoDB副本集发生主节点切换，旧主节点的所有连接被批量断开

修复方案 #

• 调整MongoDB客户端连接池参数，将maxConnectionIdleTime设置为比服务端闲置超时时间小30秒以上的值，避免连接池存留无效连接，Spring Boot配置示例如下：

spring:
  data:
    mongodb:
      uri: mongodb://你的Mongo连接地址
      socket-timeout: 30000
      connect-timeout: 10000
      pool:
        max-connection-idle-time: 1740000 # 单位毫秒，对应29分钟，小于服务端默认30分钟超时
        min-size: 5
        max-size: 100
      properties:
        socketKeepAlive: true # 开启TCP保活，避免中间网络断开闲置连接

• 开启MongoDB客户端的重试读写配置，偶发的连接异常会被自动重试，不会影响业务请求正常返回
• K8s部署场景下可以检查Mongo Service的TCP超时配置，适当调大超时时间避免中间层主动断开长连接

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