MongoDB Kotlin协程驱动客户端数小时后断开连接，如何实现连接保活而非仅延长超时？

看起来你遇到的是MongoDB客户端闲置连接被中间件（防火墙、路由或Docker网络）断开的常见问题，不用单纯依赖延长超时时间，咱们可以从几个方向配置主动保活机制，帮你解决这个问题：

1. 开启TCP保活+调整集群心跳频率 #

MongoDB Kotlin驱动支持通过MongoClientSettings配置底层TCP保活和集群监控心跳，让客户端主动维持连接：

val socketSettings = SocketSettings.builder()
    .keepAlive(true) // 开启TCP层的保活机制，操作系统会定期发送保活包防止连接被断开
    .build()

val clusterSettings = ClusterSettings.builder()
    .heartbeatFrequency(10, TimeUnit.MINUTES) // 调整集群监控心跳频率，比如每10分钟主动检查一次连接
    .build()

val settings = MongoClientSettings.builder()
    .applyConnectionString(ConnectionString(ipAddress))
    .codecRegistry(codecRegistry)
    .socketSettings(socketSettings)
    .clusterSettings(clusterSettings)
    .build()

为什么这么做？

• TCP保活让操作系统帮你定期“唤醒”闲置连接，避免被防火墙或路由判定为无效连接而断开
• 调整心跳频率可以让MongoDB客户端主动和服务器通信，验证连接可用性，同时避免过于频繁的心跳消耗资源

2. 配置连接池闲置连接自动回收 #

让客户端主动回收闲置过久的连接，避免使用已经被远端断开的无效连接：

val connectionPoolSettings = ConnectionPoolSettings.builder()
    .maxConnectionIdleTime(15, TimeUnit.MINUTES) // 闲置15分钟的连接自动从池中移除
    .build()

val settings = MongoClientSettings.builder()
    // 其他已有配置...
    .connectionPoolSettings(connectionPoolSettings)
    .build()

这样当你下次需要使用连接时，客户端会从池中取出活跃的连接，或者创建新连接，不会再碰到已断开的旧连接。

3. 优化Docker环境的网络参数 #

从你的docker-compose配置来看，MongoDB运行在Docker容器中，可能需要调整容器的TCP内核参数，强化保活能力：

在db服务的配置里添加sysctls参数：

db:
  image: mongodb/mongodb-community-server:7.0-ubuntu2204
  restart: always
  ports:
    - "27017:27017"
  volumes:
    - ./mongo_data:/data/db
  sysctls:
    - net.ipv4.tcp_keepalive_time=300  # 连接闲置5分钟后开始发送保活包
    - net.ipv4.tcp_keepalive_intvl=60  # 每60秒发送一次保活包
    - net.ipv4.tcp_keepalive_probes=5   # 连续5次失败后判定连接断开

这些参数会让容器内的TCP连接更积极地维持活跃状态，避免被Docker网络或宿主机防火墙断开。

针对你的错误日志补充说明 #

你遇到的MongoSocketReadTimeoutException是监控线程在尝试连接服务器时超时，调整集群心跳频率和开启TCP保活后，监控线程能更稳定地维持和服务器的通信，这类异常应该会消失。

备注：内容来源于stack exchange，提问作者ValentinJDT