ASP.NET Core中如何验证MongoDB连接字符串有效性

你原有的代码无法正常运行，核心原因是MongoDB .NET Driver 2.0版本后，官方彻底移除了旧服务端模型相关的API，包括GetServer()、服务端实例上的Ping()、Disconnect()方法。你原本使用的代码示例为：

var connectionString="mongodb://127.0.0.1:27017/local";
MongoClient client = new MongoClient(connectionString);
var server = client.GetServer();
server.Ping();
server.Disconnect();

新版驱动下的验证逻辑 #

验证连接有效性的核心是通过无副作用的轻量探测命令，同时覆盖两类校验场景：

• 连接字符串本身格式是否合法（比如协议写错、端口格式非法、配置参数不兼容）
• 配置正确的前提下，网络是否可达、账号权限是否匹配、MongoDB服务是否正常响应

可直接使用的异步实现 #

依托新版驱动的数据库命令接口，可以直接对admin系统库发送ping探测命令，该操作不会修改任何业务数据，资源消耗几乎可以忽略：

using MongoDB.Driver;
using MongoDB.Bson;

/// <summary>
/// 校验MongoDB连接字符串有效性
/// </summary>
/// <param name="connectionString">待校验的连接字符串</param>
/// <returns>校验通过返回true，否则返回false</returns>
public async Task<bool> CheckMongoConnectionValid(string connectionString)
{
    try
    {
        var client = new MongoClient(connectionString);
        var pingCommand = BsonDocument.Parse("{ ping: 1 }");
        // 直接对admin库执行ping命令，无需依赖连接字符串中指定的业务库
        await client.GetDatabase("admin").RunCommandAsync<BsonDocument>(pingCommand);
        return true;
    }
    catch (MongoConfigurationException)
    {
        // 捕获连接字符串格式不合法的配置类错误
        return false;
    }
    catch (MongoConnectionException)
    {
        // 捕获网络不可达、认证失败、服务端超时等运行时连接问题
        return false;
    }
}

实操注意事项 #

• MongoClient本身设计为可长期复用的单例对象，内置了管理连接池的逻辑，不要在每次探测后手动调用断连操作，主动断连会造成不必要的TCP连接重建开销；ASP.NET Core项目中推荐将MongoClient注册为单例服务通过依赖注入复用，不要在业务代码中频繁实例化
• 上述实现的探测操作不需要依赖连接字符串中指定的业务库权限，只要账号能访问admin库的基础ping命令即可完成校验，适配绝大多数常规连接场景

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