为何Python Motor客户端访问MongoDB时约50%的查询出现连接断开问题

根因说明 #

50%无规律超时、Mongo日志出现Received interrupt request for unknown op错误、查询耗时极短仍被中断，本质是上层调用链先于数据库查询返回触发了连接主动断开，和Mongo驱动本身设置的超时参数无关。

修复步骤 #

• 调整Uvicorn服务超时配置
  默认Uvicorn的请求超时阈值较低，并发请求排队时容易触发超时主动断连。启动服务时新增--timeout-keep-alive 120参数调高超时时间，K8s部署时需将该参数写入容器启动命令。
• 修正Motor客户端初始化逻辑
  异步场景下不要给AsyncIOMotorClient传connect=True参数，该参数会触发同步阻塞建连，容易导致连接池状态异常，去掉该参数让驱动自动异步建连即可，修改后代码如下：

  try:
      # kwargs包含username、password、connectTimeoutMS、socketTimeoutMS、serverSelectionTimeoutMS参数
      return AsyncIOMotorClient(host, port, appname=appname, **kwargs)
  except:
      # 记录异常日志
  

• 校验K8s层超时配置
  检查Mongo服务对应的K8s Service、Ingress代理超时阈值，同时检查应用Pod的存活探针、就绪探针的超时配置，避免探针误判导致容器重启或连接被强制切断。
• 优化Mongo连接池与重试配置
  连接参数中新增retryReads=True开启读请求重试，同时根据应用并发规模调整maxPoolSize参数值，避免连接池耗尽导致的等待超时。
• 确认GraphQL异步Resolver实现正确
  从错误栈可见你用了promise库调度异步请求，需确保所有涉及数据库操作的Resolver都正确声明为async类型，不要在异步Resolver中调用同步IO操作阻塞事件循环，避免回调无法被触发引发主动断连。

验证方式 #

修改完成后本地单实例压测100次相同查询，确认无超时后再上线K8s环境。

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