authSource=admin）、网络环境（VPC 内网访问）、密码特殊字符转义等要点，在示例中给出明确说明。连接要素 | 获取方式 | 说明 |
内网地址与端口 | 实例详情 > 网络配置 | 格式为 IP:27017，副本集实例提供多个 IP |
用户名 | 默认用户 mongouser，或在数据库管理页面创建 | 控制台创建的用户统一使用 admin 作为认证库 |
密码 | 创建实例时设置 | 如包含 @、:、/ 等特殊字符，需进行 URL 编码转义 |
认证数据库 | 固定为 admin | URI 中必须指定 authSource=admin |
// 副本集实例mongodb://mongouser:<password>@<IP1>:27017,<IP2>:27017,<IP3>:27017/<database>?authSource=admin&replicaSet=<replicaSetName>// 分片集群实例（连接 mongos 节点）：mongodb://mongouser:<password>@<mongosIP1>:27017,<mongosIP2>:27017/<database>?authSource=admin
readPreference=secondaryPreferred 参数，优先从从节点读取数据。@、:、/、%）需进行 URL 编码，例如 @ 编码为 %40。语言/工具 | 推荐驱动 | 推荐版本 | 连接示例 | 适用场景 |
Java | MongoDB Java Driver | 4.9或以上 | 企业级后端应用、Spring 生态集成 | |
Python | PyMongo | 4.6或以上 | 数据分析、Web 后端、脚本自动化 | |
Go | MongoDB Go Driver | 1.13或以上 | 高并发后端服务、微服务架构 | |
Node.js | MongoDB Node.js Driver | 6.0或以上 | Web 后端服务、Serverless 应用 | |
PHP | MongoDB PHP Library | 1.17或以上 | Web 应用开发 |
authSource=admin 认证库。rwuser，使用 MONGODB-CR 认证方式。该认证方式已不推荐使用，如您的实例存在 rwuser 用户，建议迁移至 mongouser 或新建用户。认证方式 | 适用用户 | 说明 |
SCRAM-SHA-1 | mongouser 及控制台创建的所有用户 | 兼容所有版本的默认认证方式，客户端无需额外指定 authMechanism 参数。 |
SCRAM-SHA-256 | 控制台创建的用户（MongoDB 4.0及以上版本） | 安全性更高的认证方式，4.0+客户端驱动会自动优先协商使用；若需强制使用，需在连接串中显式指定 authMechanism=SCRAM-SHA-256。 |
参数 | 建议值 | 说明 |
maxPoolSize | 50 - 200 | 连接池上限，根据应用并发量和实例规格调整。建议不超过实例最大连接数的80% |
minPoolSize | 5 - 20 | 连接池下限，保持一定数量的空闲连接，减少冷启动延迟 |
connectTimeoutMS | 10000 | 连接超时时间（毫秒），内网环境下10秒足够 |
socketTimeoutMS | 30000 | 套接字超时时间（毫秒），根据业务查询复杂度调整 |
maxIdleTimeMS | 60000 | 空闲连接最大存活时间（毫秒），避免长时间闲置被服务端断开 |
retryWrites | true | 启用可重试写入，提升网络抖动场景下的写入可靠性 |
retryReads | true | 启用可重试读取，提升读取可靠性 |
w | majority | 写入关注级别，确保数据写入多数节点后再返回确认 |
已停维驱动 | 替代驱动 |
mongo-java-driver（Java 3.x） | mongodb-driver-sync（4.x 及以上） |
mgo（Go 社区驱动） | go.mongodb.org/mongo-driver（官方驱动） |
PyMongo 3.x | PyMongo 4.x |
telnet 实例访问IP地址 端口
maxPoolSize 与业务并发量匹配。文档反馈