从Azure App Service连接MongoDB Atlas超时问题排查求助

问题重现 #

本地运行时以下代码可正常连接MongoDB Atlas，但部署到Azure后，API端点在30秒后超时，报错如下：

"A timeout occurred after 30000ms selecting a server using CompositeServerSelector{ Selectors = MongoDB.Driver.MongoClient+AreSessionsSupportedServerSelector, LatencyLimitingServerSelector{ AllowedLatencyRange = 00:00:00.0150000 }, OperationsCountServerSelector }. Client view of cluster state is { ClusterId : "1", ConnectionMode : "ReplicaSet", Type : "ReplicaSet", State : "Disconnected", Servers : [] }."

已临时开启MongoDB Atlas的「允许所有IP访问」，但问题仍存在。

相关代码 #

public ReplybotServiceLayer(MongoDbSettings databaseSettings)
{
    var connectionString = $"mongodb+srv://{databaseSettings.User}:{databaseSettings.Password}@{databaseSettings.Cluster}.mongodb.net/{DatabaseName}?w=majority&connect=replicaSet";
    var client = new MongoClient(connectionString);
    var database = client.GetDatabase(DatabaseName);
    _guildResponsesCollection = database.GetCollection<GuildResponseEntity>("responses");
    _guildConfigurationsCollection = database.GetCollection<GuildConfigurationEntity>("configuration");
}

public async Task<IList<TriggerResponse>?> GetResponsesForGuild(ulong guildId)
{
    var filter = Builders<GuildResponseEntity>.Filter.Eq("guildId", guildId.ToString());
    var guildResponses = await _guildResponsesCollection.Find(filter).FirstOrDefaultAsync();
    var triggerResponses = guildResponses?.Responses;
    return triggerResponses?.Select(tr => tr.ToDomain()).ToList();
}

可能的原因 #

• Azure网络出站限制：即使Atlas放开了IP，Azure的网络规则可能仍阻止流量。比如App Service的VNet集成配置、NSG（网络安全组）出站规则，可能未放行MongoDB的端口（默认27017，ReplicaSet还需要访问集群内其他节点的端口）；部分Azure环境可能默认限制出站到非标准端口的流量。
• 连接字符串参数缺失/错误：当前连接字符串的connect=replicaSet可能需要配合其他参数。比如显式指定ssl=true（尽管srv连接默认启用SSL，但Azure环境下可能需要强制指定）、调整超时参数（connectTimeoutMS=30000、socketTimeoutMS=30000）、添加retryWrites=true；另外，需确认集群域名在Azure环境下能正常解析。
• TLS版本不兼容：MongoDB Atlas要求使用TLS 1.2或更高版本，若Azure运行环境的默认TLS版本低于此，会导致连接失败。
• 驱动版本兼容性：本地使用的MongoDB .NET驱动版本与Azure运行环境的版本不一致，可能存在兼容性问题，导致ReplicaSet连接逻辑异常。

排查与调试方法 #

1. 启用MongoDB驱动详细日志 #

通过配置MongoClientSettings开启调试日志，查看连接过程的细节（DNS解析、握手、服务器选择等）：

var settings = MongoClientSettings.FromConnectionString(connectionString);
settings.ClusterConfigurator = builder =>
{
    builder.Subscribe<CommandStartedEvent>(e =>
    {
        Console.WriteLine($"Command {e.CommandName} started on database {e.DatabaseName}");
    });
    builder.Subscribe<ServerHeartbeatFailedEvent>(e =>
    {
        Console.WriteLine($"Server heartbeat failed: {e.Failure.Message}");
    });
};
var client = new MongoClient(settings);

也可以在appsettings.json中添加日志配置，将MongoDB.Driver的日志级别设为Debug：

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "MongoDB.Driver": "Debug",
      "MongoDB.Driver.Core": "Debug"
    }
  }
}

2. 检查Azure网络连通性 #

• 使用Azure App Service的Kudu控制台（路径：https://<your-app-name>.scm.azurewebsites.net/），打开PowerShell，执行以下命令测试端口连通性：

  Test-NetConnection <your-cluster-domain>.mongodb.net -Port 27017
  

• 查看Azure资源的NSG流日志或App Service的网络日志，确认是否有到MongoDB集群的出站流量被拒绝。

3. 调整连接字符串参数 #

尝试修改连接字符串，添加必要参数：

mongodb+srv://{user}:{password}@{cluster}.mongodb.net/{dbName}?w=majority&connect=replicaSet&ssl=true&connectTimeoutMS=30000&socketTimeoutMS=30000&retryWrites=true

4. 强制指定TLS版本 #

在代码中显式配置TLS 1.2：

var settings = MongoClientSettings.FromConnectionString(connectionString);
settings.SslSettings = new SslSettings
{
    EnabledSslProtocols = SslProtocols.Tls12
};
var client = new MongoClient(settings);

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