Docker-Compose下PyMongo引发Mongo连接波浪式创建问题排查

一、Python代码侧（PyMongo连接逻辑） #

• 检查连接池配置：PyMongo默认靠连接池管理连接，要是你每次接口请求都新建MongoClient而不是全局复用单例，必然会频繁创建、销毁连接。确认代码里是不是只初始化一次MongoClient，并在所有请求里复用这个实例，别在接口函数里重复初始化。
• 查看连接超时参数：给MongoClient设置合理的connectTimeoutMS和socketTimeoutMS，超时设置太短的话，连接可能还没完成操作就被强制断开。
• 排查连接回收逻辑：有没有多余的手动client.close()操作？PyMongo的连接池会自动管理连接生命周期，手动关闭会直接销毁连接，导致频繁重建。
• 检查认证逻辑：是不是每次请求都重复做认证？正常情况下MongoClient初始化时就完成认证了，后续请求复用连接就行，重复认证会额外增加连接开销。

二、MongoDB配置侧 #

• 查看连接数限制：Mongo默认maxIncomingConnections是1000，但Docker容器的内存、CPU如果不够，实际能扛的连接数会低很多。可以在Mongo shell里执行db.runCommand({getParameter:1, maxIncomingConnections:1})看当前配置，同时用docker stats监控容器的资源使用率。
• 检查超时配置：看看Mongo的net.maxIdleTimeMS是不是设得太短？闲置连接被过早回收的话，客户端就得频繁重建连接。另外也确认下net.socketTimeoutMS的设置是否合理。
• 深挖日志细节：把Mongo的日志级别调到verbose，看连接断开时的具体错误信息（比如connection refused、socket exception），搞清楚是客户端主动断开，还是Mongo这边被动中断。

三、Docker网络与资源配置 #

• 检查网络模式：如果用的是默认桥接网络，可能存在端口映射冲突或者网络延迟问题。试试把Mongo和FastAPI放到同一个自定义Docker网络里，减少跨网络的开销。
• 监控容器资源：用docker stats盯着Mongo容器的CPU、内存、磁盘IO，是不是资源耗尽导致连接中断？比如内存不足触发OOM kill，就会出现间歇性无响应。
• 调整日志存储：Docker默认日志缓冲区有限，要是Mongo日志量太大撑爆缓冲区，会影响IO性能。建议配置Mongo把日志写到持久化的文件里，别依赖Docker的日志缓冲区。

四、连接行为验证 #

• 用mongostat实时监控：在Mongo容器里运行mongostat --discover，盯着conn字段看连接数变化，确认是不是和日志里的N递增规律一致，判断是客户端主动创建连接，还是Mongo被动接受。
• 模拟请求测试：写个简单的Python脚本，复用同一个MongoClient发起批量请求，看会不会出现同样的连接波动和断开问题，排除FastAPI框架的影响。

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