MongoDart连接MongoDB专用集群时认证失败问题求助

我用Dart做后端，搭配MongoDart开发。之前使用MongoDB无服务器实例时一切正常，但切换到3节点的MongoDB专用集群（部署名com-new，数据库名main）后，出现认证失败错误：

MongoDartError (MongoDart Error: Authentication failed.)

我的连接代码如下：

var db = await Db.create('mongodb+srv://com-admin:*****@com-new.iv00u.mongodb.net/main');
await db.open(); // 此处抛出认证错误

该连接方式在MongoDB Compass和Mongoose中可正常工作，但在MongoDart中报错。我尝试添加authSource参数，使用以下两种连接字符串：

mongodb+srv://com-admin:*****@com-new.iv00u.mongodb.net/main?authSource=admin

以及：

mongodb+srv://com-admin:*****@com-new.iv00u.mongodb.net/main/?authSource=admin

旧的无服务器实例用该连接可正常运行，但因需使用仅专用/共享集群支持的changeStreams功能，必须切换至专用集群，特此求助解决认证问题。

1. 升级MongoDart到最新版本 #

旧版本MongoDart可能对专用集群的SRV连接或认证逻辑支持不足。更新pubspec.yaml中的依赖：

dependencies:
  mongo_dart: ^0.9.0 # 替换为当前最新稳定版

执行dart pub get完成依赖更新后重试连接。

2. 显式指定认证机制与源 #

在调用db.open()时，通过authenticationSettings参数明确指定认证机制和源，比URL参数更可靠：

var db = await Db.create('mongodb+srv://com-admin:*****@com-new.iv00u.mongodb.net/main');
await db.open(
  authenticationSettings: AuthenticationSettings(
    mechanism: 'SCRAM-SHA-256',
    authSource: 'admin',
  ),
);

3. 检查用户权限与IP白名单 #

• 确认com-admin用户在专用集群中拥有main数据库的读写权限，且角色配置正确；
• 检查集群的IP白名单，确保你的服务器IP已被添加（无服务器实例可能默认允许所有IP，而专用集群通常会限制IP访问，这可能导致看似认证失败的错误）。

4. 转义密码中的特殊字符 #

如果密码包含@、:、/等特殊字符，必须进行URL编码。可以用Dart的Uri.encodeComponent处理：

String rawPassword = 'your-password-with-special-chars';
String encodedPassword = Uri.encodeComponent(rawPassword);
var db = await Db.create(
  'mongodb+srv://com-admin:$encodedPassword@com-new.iv00u.mongodb.net/main',
);

5. 使用标准连接字符串替代SRV格式 #

从MongoDB Atlas获取非SRV的标准连接字符串（包含所有分片节点地址），直接替换到代码中：

var db = await Db.create(
  'mongodb://com-admin:*****@com-new-shard-00-00.iv00u.mongodb.net:27017,com-new-shard-00-01.iv00u.mongodb.net:27017,com-new-shard-00-02.iv00u.mongodb.net:27017/main?ssl=true&replicaSet=atlas-xxxxxx-shard-0&authSource=admin&retryWrites=true&w=majority',
);
await db.open();

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