本地Azure函数连接Docker版Mongo时持续出现ServerSelectionTimeoutError

• 本地Azure函数无法连接MongoDB，返回ServerSelectionTimeoutError
• 尝试过localhost和Docker容器IP（172.17.0.2），直接用这两个地址访问数据库正常，但Azure函数连接失败
• 已在local.settings.json配置MONGO_URL环境变量，系统能正确读取（错误日志显示使用了指定IP）
• 调试时，在创建MongoClient前添加打印语句，但连接操作先于打印执行

相关代码 #

env = os.getenv("MONGO_URL")
client = pymongo.MongoClient(env)
db = client["data"]
col = db["objects"]

错误日志 #

[2023-05-31T16:04:33.213Z] Executed 'Functions.HttpTrigger1' (Failed, Duration=30422ms)
[2023-05-31T16:04:33.213Z] System.Private.CoreLib: Exception while executing function: Functions.HttpTrigger1. System.Private.CoreLib: Result: Failure
[2023-05-31T16:04:33.213Z] Exception: ServerSelectionTimeoutError: 172.17.0.2:27017: timed out, Timeout: 30s, Topology Description: <TopologyDescription topology_type: Unknown, servers: [<ServerDescription ('172.17.0.2', 27017) server_type: Unknown, rtt: None, error=NetworkTimeout('172.17.0.2:27017: timed out')>]>

local.settings.json配置 #

{
  "IsEncrypted": false,
  "Values": {
    "FUNCTIONS_WORKER_RUNTIME": "python",
    "AzureWebJobsStorage": "UseDevelopmentStorage=true",
    "AzureWebJobsFeatureFlags": "EnableWorkerIndexing",
    "MONGO_URL": "mongodb://172.17.0.2:27017"
  }
}

1. 调整MongoClient初始化位置 #

Azure Functions本地运行时，会在启动阶段加载函数文件的全局代码。如果MongoClient的初始化在函数外部（全局作用域），会在函数执行前就尝试连接，导致调试打印语句（如果在函数内部）还没执行就触发连接错误。

将客户端初始化移到函数内部，确保连接操作在函数执行时触发，同时添加打印和显式连接测试：

import os
import pymongo
from azure.functions import HttpRequest, HttpResponse

def main(req: HttpRequest) -> HttpResponse:
    env = os.getenv("MONGO_URL")
    print(f"Connecting to: {env}")
    try:
        client = pymongo.MongoClient(env, serverSelectionTimeoutMS=5000)
        # 显式测试连接
        client.admin.command('ping')
        db = client["data"]
        col = db["objects"]
        return HttpResponse("连接成功")
    except pymongo.errors.ServerSelectionTimeoutError as e:
        return HttpResponse(f"连接失败: {str(e)}", status_code=500)

2. 检查Docker网络配置 #

如果MongoDB运行在Docker容器中，确保Azure Functions本地运行环境能正常访问：

• 若Azure Functions用Docker运行，需将两个容器加入同一个Docker网络，使用容器名称作为连接地址（比如mongodb://mongo-container:27017），避免使用易变的容器IP
• 若Azure Functions本地直接运行（非容器），确认MongoDB容器已映射27017端口到本地主机（启动容器时添加-p 27017:27017参数），此时用localhost:27017作为连接地址

3. 优化MongoDB连接参数 #

在创建MongoClient时添加以下参数，提升连接稳定性：

• serverSelectionTimeoutMS: 缩短超时时间，快速排查问题
• connectTimeoutMS: 控制连接超时时长
• directConnection=True: 强制直接连接（适用于单节点MongoDB，避免拓扑发现逻辑导致的异常）

示例：

client = pymongo.MongoClient(
    env,
    serverSelectionTimeoutMS=5000,
    connectTimeoutMS=3000,
    directConnection=True
)

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