Azure Cosmos DB for MongoDB(vCore)连接字符串在.NET 8中无效问题

可能的原因及解决步骤 #

1. 确认MongoDB.Driver版本兼容性 #

Azure Cosmos DB for MongoDB vCore需要使用较新版本的MongoDB .NET驱动，建议升级到MongoDB.Driver 2.20.0及以上版本。旧版本驱动可能不支持mongodb+srv格式的连接字符串解析，或者对Cosmos DB特定参数处理存在问题。

2. 检查连接字符串的特殊字符转义 #

如果用户名或密码包含特殊字符（如@、:、/、+等），需确保这些字符已被URL编码。虽然Azure提供的连接字符串通常已处理，但配置文件读取时可能出现转义丢失：

• 在appsettings.json中，确保连接字符串用双引号包裹，没有多余的空格或换行。
• 若手动拼接，使用Uri.EscapeDataString()对用户名和密码进行编码后再构建连接字符串。

3. 手动构建MongoClientSettings替代连接字符串 #

直接使用连接字符串解析可能存在兼容性问题，手动构建配置参数更可靠：

public NetworkService(IOptions<MongoDBSettings> mongoDBSettings)
{
    // 从连接字符串初始化基础配置
    var mongoUrl = new MongoUrl(mongoDBSettings.Value.ConnectionLocal);
    var settings = MongoClientSettings.FromUrl(mongoUrl);
    
    // 强制指定TLS 1.2（Cosmos DB要求）
    settings.SslSettings = new SslSettings 
    { 
        EnabledSslProtocols = System.Security.Authentication.SslProtocols.Tls12 
    };
    
    // 显式设置Cosmos DB必需的参数
    settings.RetryWrites = false;
    settings.MaxIdleTime = TimeSpan.FromMilliseconds(120000);
    
    _client = new MongoClient(settings);
}

或者完全手动构建配置（避免连接字符串解析问题）：

public NetworkService(IOptions<MongoDBSettings> mongoDBSettings)
{
    var settings = new MongoClientSettings
    {
        Server = new MongoServerAddress("mongodb-test.mongocluster.cosmos.azure.com", 10255),
        Credential = MongoCredential.CreateScramSha256Credential(
            "admin", // Cosmos DB vCore默认认证数据库为admin
            mongoDBSettings.Value.Username,
            mongoDBSettings.Value.Password
        ),
        UseTls = true,
        RetryWrites = false,
        MaxIdleTime = TimeSpan.FromMilliseconds(120000)
    };
    _client = new MongoClient(settings);
}

4. 添加authSource参数到连接字符串 #

在Azure提供的连接字符串末尾追加&authSource=admin，明确指定认证数据库：

mongodb+srv://<hidden>@mongodb-test.mongocluster.cosmos.azure.com/?tls=true&authMechanism=SCRAM-SHA-256&retrywrites=false&maxIdleTimeMS=120000&authSource=admin

5. 验证配置读取正确性 #

确保mongoDBSettings.Value.ConnectionLocal确实读取到了完整的连接字符串：

• 在初始化MongoClient前添加日志或调试代码，输出连接字符串内容（注意隐藏敏感信息），确认没有被截断或篡改。

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