mongodb connection pool exhausted 错误本质是连接请求持续排队无法获取可用连接，需调优连接池参数、强制关闭gridfs流、注入超时控制、限制分片连接爆炸、压降mongos连接数。
如果您在应用日志中看到 MongoDB 报 connection pool exhausted，该错误并非单纯由连接数配置过小导致，而是客户端连接池资源被长期占用、复用率低或泄漏引发的表象。其本质是连接请求持续排队却无法获取可用连接，常见于高并发 GridFS 操作、分片集群路由放大、流未关闭、超时缺失等场景。以下是解决此问题的步骤：
一、检查并调优 MongoClient 连接池核心参数
默认连接池配置（如 maxPoolSize=100）在高并发下易触达上限，但盲目增大可能加剧后端压力。需结合业务特征调整关键生命周期参数，提升连接周转效率。
1、将 maxPoolSize 设为 200–400，避免低于 200 导致冷启动排队，同时严控不超过 500 以防 mongod 端 net.maxIncomingConnections 被打满；
2、设置 minPoolSize 为 20–50，确保空闲期保有基础连接，规避突发流量时反复建连开销；
3、启用 maxConnectionIdleTime 并设为 5–10 分钟，比默认 30 分钟更激进地回收空闲连接；
4、配置 maxConnectionLifeTime 为 30–60 分钟，强制淘汰老化连接，防止因网络抖动积累半开连接。
二、强制关闭 GridFS 流以杜绝资源泄漏
GridFS 的 uploadFromStream 和 downloadToStream 操作若未显式终止流，连接将长期滞留池中不释放，这是耗尽最常见根源。
1、Node.js 中调用 stream.destroy() 或监听 'close' 事件后执行清理；
2、Java 中必须使用 try-finally 块包裹 GridFSDownloadStream，即使发生异常也调用 close()；
3、禁止依赖 try-with-resources 自动关闭——异常中断时 AutoCloseable 可能未触发，必须手动保障关闭逻辑执行。
三、为 GridFS 操作显式注入超时与错误控制
默认无操作级超时，单个分块上传/下载卡住（如网络延迟、磁盘响应慢）即阻塞整条连接，造成池内连接“假死”。
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
1、Java 驱动中，在 GridFSUploadOptions 或 GridFSDownloadOptions 内传入 timeout(30, TimeUnit.SECONDS)；
2、Node.js 驱动中，对 bucket.openUploadStream() 返回的 WriteStream 绑定 on('error', () => stream.abort())；
3、下载时对返回流调用 stream.setTimeout(30000)，超时后自动中断并释放连接。
四、限制 mongos 到 shard 的连接爆炸效应
分片集群中，mongos 为每次请求涉及的每个 shard 单独建连，客户端 100 连接 × 8 shard 可能生成近 800 后端连接，远超预期。
1、禁用 driver 层 retryWrites=true 对 GridFS 分块写无效，改为业务层对整个文件上传/下载做幂等重试；
2、上传失败后立即调用 bucket.delete() 清理残留 chunk，避免后续查询跨分片放大连接需求；
3、核查分片键设计，避免全表扫描或范围查询覆盖多数 chunk，减少单次请求波及 shard 数量。
五、验证并压降 mongos 内部连接数
mongos 自身无硬性连接限制，仅靠 connPoolMaxSize（默认 1000）软控，超限后新请求被阻塞，需从 mongos 配置侧主动压降。
1、在 mongos 启动参数中添加 --connPoolMaxSize 500，明确限制后端连接总数；
2、通过 netstat -an | grep :27017 | wc -l 实时统计 mongos 到各 shard 的连接数，确认是否显著高于客户端连接数 × shard 数；
3、若发现连接数持续高位，配合降低客户端 maxPoolSize 并启用 serverSelectionTimeoutMS=3000，加速失败请求退出，缓解排队积压。
