本文汇总云数据库 MongoDB 在连接访问过程中的高频问题，涵盖连接方式、驱动选择、认证机制、连接数、断连重连与内外网访问等。
支持哪些语言和客户端连接 MongoDB？
云数据库 MongoDB 完全兼容原生 MongoDB 协议，MongoDB 官方支持的客户端和驱动均可直接连接使用，无需特殊适配。常用的语言驱动包括：
MongoDB Shell（mongosh）
Java、Python、Go、Node.js、PHP、C#/.NET、C/C++、Ruby、Rust 等
应该选择哪个版本的驱动程序？
建议使用与实例版本相匹配的官方最新稳定版驱动。各语言驱动在大版本上会随 MongoDB 内核演进，使用过旧的驱动可能不支持新版本的认证方式或特性（例如
SCRAM-SHA-256 认证、Retryable Writes 等）。请前往 MongoDB 官方驱动文档获取对应语言的最新稳定版本，并优先使用支持自动重连的官方驱动。
MongoDB 使用哪种认证方式？
云数据库 MongoDB 现行版本采用
SCRAM-SHA-256 与 SCRAM-SHA-1 认证机制。早期的 MONGODB-CR 认证方式已被 MongoDB 官方废弃，现行版本不再支持，请勿在连接参数中指定该机制。连接时认证数据库通常为
admin，URI 中通过 authSource=admin 指定。业务程序连接 MongoDB 的 URI 是什么样的？
标准连接串格式如下，请将其中的占位符替换为实例的真实连接信息：
mongodb://<username>:<password>@<host>:<port>/<database>?authSource=admin
副本集实例可在连接串中携带多个节点地址，由驱动自动完成主从识别与故障切换。
指定从节点读取时可追加
readPreference=secondaryPreferred。完整连接示例与各语言示例请参见 连接实例。
在 MongoDB Shell（mongosh）中如何连接实例？
使用如下命令连接，并按提示输入密码：
mongosh "mongodb://<username>@<host>:<port>/admin"
MongoDB 支持外网连接吗？
支持。 实例默认仅支持私有网络（VPC）内网访问，如需从本地或外部环境连接，可在控制台为实例开启外网访问，系统将分配独立的外网访问地址。
MongoDB 的连接数限制是多少？是否可以提升？
如何在应用中控制连接数（连接池）？
通过在连接 URI 中配置连接池参数控制：
maxPoolSize：连接池最大连接数。minPoolSize：连接池最小保持连接数。maxIdleTimeMS：空闲连接的最长保持时间。mongodb://<username>:<password>@<host>:<port>/admin?maxPoolSize=100&minPoolSize=10
Running Environment
Operating System: Ubuntu 24.04.3 LTS / x86_64
Runtime Version: GNU bash, version 5.2.21(1)-release (x86_64-pc-linux-gnu)
建议根据业务并发量合理设置
maxPoolSize，避免连接数耗尽实例上限。连接出现 "Remote server has closed the connection" 怎么办？
云数据库 MongoDB 通过接入层（类 mongos 路由）对外提供服务，客户端经由该接入层与后端建立长连接。当连接长时间处于空闲状态时，接入层会主动回收该连接。
大多数官方驱动已实现自动重连，无需额外处理。
若使用的驱动未实现自动重连，复用已被回收的连接时会收到该错误。此时需在应用侧实现重连机制，在捕获连接异常后重新建立连接并重试。
建议优先使用支持自动重连和 Retryable Writes 的官方最新驱动。
使用框架或 ORM（如 Mongoose）无法连接，如何排查？
此类问题多为连接串拼接或参数配置错误，请按以下顺序排查：
1. 核对 host、port、username、password 是否正确。
2. 确认
authSource=admin，且未指定已废弃的 MONGODB-CR 认证。3. 确认客户端所在网络与实例 VPC 互通（内网访问），或已开启外网访问（外网访问）。
4. 确认安全组放通了对应端口。
5. 升级到与实例版本兼容的最新驱动/框架版本。
以 Mongoose 为例：
const mongoose = require('mongoose');const uri = `mongodb://${user}:${encodeURIComponent(password)}@${host}:${port}/${dbName}?authSource=admin`;await mongoose.connect(uri);
注意：
密码中若含特殊字符，需进行 URL 编码。
