Python后端连接MongoDB时如何设置请求超时时间？

你设置的connectTimeoutMS和socketTimeoutMS主要针对已建立连接后的操作或初始TCP连接阶段的超时，但ServerSelectionTimeoutError是客户端在选择可用服务器时的等待超时，需要单独配置serverSelectionTimeoutMS参数才能解决。

正确的连接参数配置 #

修改连接选项，添加serverSelectionTimeoutMS参数：

# Connection options
connection_options = {
    "connectTimeoutMS": 5000,          # TCP连接握手超时
    "socketTimeoutMS": 5000,           # 已连接状态下的socket读写超时
    "serverSelectionTimeoutMS": 5000   # 服务器选择阶段的超时（关键参数）
}

client = pymongo.MongoClient(connection_string, **connection_options)

额外优化建议 #

• 提前验证连接：在应用启动阶段主动触发连接验证，避免首次业务请求才触发超时逻辑：

  try:
      # 发送ping命令验证连接，会立即触发服务器选择逻辑
      client.admin.command('ping')
  except pymongo.errors.PyMongoError:
      # 处理连接失败逻辑
      print("MongoDB connection failed")
  

• 精准捕获异常：单独捕获ServerSelectionTimeoutError，可以返回更贴合场景的错误提示：

  try:
      matching_locations_list = list(location_collection.find({"username": username}))
  except pymongo.errors.ServerSelectionTimeoutError:
      return ["MongoDB server unreachable (check IP whitelist or network status)"]
  except pymongo.errors.PyMongoError:
      return ["MongoDB connection error"]
  

为什么之前的参数无效？ #

• connectTimeoutMS：仅控制TCP握手阶段的超时，IP白名单被拒时，客户端仍会尝试遍历连接字符串中的所有节点，不会直接终止等待。
• socketTimeoutMS：仅作用于已建立连接后的读写操作，不影响服务器选择阶段的等待时长。
• serverSelectionTimeoutMS：专门控制客户端在尝试寻找可用服务器时的最长等待时间，超时后直接抛出ServerSelectionTimeoutError，完全匹配你的需求。

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