特定项目MongoDB连接等待队列满导致连接失败问题排查求助

可能的原因 #

• maxConnecting配置过低：你当前设置的maxConnecting: "4"是驱动允许同时发起的新连接请求上限。当特定项目的请求集中触发时，连接池内可用连接耗尽后，新连接的创建被严格限制，导致等待获取连接的队列迅速填满——这也是错误在2秒内触发的核心原因，这不是连接超时，而是等待连接池可用连接的队列满超时，和默认30秒的连接超时不是一回事。
• 特定项目查询耗时异常：虽然是按UUID查询文档，但如果该项目的UUID索引失效/不存在，会触发全集合扫描，导致连接被长时间占用；或者该项目的文档体积过大，传输耗时远超常规，同样会占用连接池资源，引发队列满。
• 连接池泄漏：特定项目的代码可能存在连接未正确释放的情况，比如未遵循MongoClient单例模式（每次请求创建新实例会耗尽连接）、异步操作未正确await导致连接挂起，这些都会让连接无法回到池内，逐步耗尽可用连接。
• 驱动版本兼容性问题：如果近期升级过MongoDB .NET驱动，可能存在版本特定的连接池管理bug，在特定场景下触发队列满问题。

解决方法 #

1. 调整maxConnecting参数 #

将maxConnecting从4调高，建议设置为maxConnectionPoolSize的1/5~1/3（比如80-130），允许驱动同时创建更多新连接，应对突发的连接需求。修改后的配置示例：

mongoDB:
  maxConnectionPoolSize: "400"
  minConnectionPoolSize: "10"
  maxConnecting: "100"  # 调整此处
  maxConnectionIdleTime: "300000"
  maxConnectionLifeTime: "1800000"

2. 排查特定项目的查询性能 #

• 检查该项目UUID字段的索引状态：在MongoDB shell中执行db.yourCollection.getIndexes()，确认UUID字段有对应的单键索引，且索引状态正常。
• 分析查询执行计划：对该项目的查询执行db.yourCollection.find({uuid: "目标UUID"}).explain("executionStats")，查看是否有全表扫描（stage为COLLSCAN）、耗时过长的阶段。
• 若文档体积过大，评估是否可以拆分文档，或调整查询仅返回必要字段（即使业务需要完整文档，也可确认是否存在冗余字段）。

3. 检查连接池泄漏问题 #

• 确保MongoClient是单例模式：整个应用中只创建一次MongoClient实例，不要在每次请求中新建，否则会创建大量独立的连接池，耗尽资源。
• 检查异步代码：所有涉及MongoDB的异步操作必须正确使用await，避免因未等待操作完成导致连接被长时间持有。
• 启用驱动连接池日志：在测试环境中配置MongoDB驱动的日志，跟踪连接的Acquired、Released事件，定位是否有连接未被释放。

4. 调整连接等待超时（临时缓解） #

如果需要临时缓解问题，可以设置WaitQueueTimeout参数（默认可能为2秒），延长等待连接的时间，比如设为10秒：

mongoDB:
  # 其他配置不变
  waitQueueTimeout: "10000"  # 单位毫秒

注意：这只是临时方案，需配合其他根本解决措施。

5. 验证驱动版本 #

如果近期升级过驱动，尝试回退到之前稳定的版本；若未升级，考虑升级到最新的官方稳定版，修复可能存在的连接池bug。

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