通过 URI 连接串连接

最近更新时间:2025-10-23 12:23:02

我的收藏
本方法适用于在应用程序代码中使用各种编程语言驱动进行连接 MongoDB 实例。

获取标准 URI 连接串

1. 登录 MongoDB 控制台
2. 在实例列表中找到目标实例。
3. 进入实例详情页,在网络配置区域的访问地址中,复制完整的连接串,如下图所示。

关键连接参数详解,请参见下表。更多内容,请参见 MongoDB 官网文档
参数
含义
是否必须
备注
mongodb://
MongoDB 协议标识符
-
username:password
数据库认证信息
默认用户:云数据库 MongoDB 内建了默认用户 mongouser
自定义用户:在 MongoDB 控制台数据库管理页面,可创建新的用户。具体操作,请参见 账号管理
host:port
实例节点地址
支持多个地址,用逗号分隔。
/admin 或 authSource=admin
认证数据库
控制台创建的用户:认证库统一为 admin,连接时需指定 authSource=admin。
命令行创建的用户:认证库为其被创建时所在的数据库(例如在 test 库创建,则认证库为 test)。
replicaSet
副本集 ID
标识实例的副本集名称。
authMechanism=SCRAM-SHA-1
认证机制
认证机制:SCRAM-SHA-1 与 SCRAM-SHA-256 两种认证方式。
readPreference
读偏好设置

控制读请求的路由。例如:mongodb://.../admin?readPreference=secondaryPreferred
primary:(默认)所有读请求只发往主节点。
primaryPreferred:主节点优先,如主节点不可用,则读从节点/只读节点。
secondary:从节点/只读节点,如从节点不可用会报错。
secondaryPreferred:从节点/只读节点优先,如从节点/只读节点不可用,则读主节点。

多语言连接示例

您可以使用此连接串,配合不同语言的 MongoDB 驱动进行连接。
驱动下载:请使用最新版的客户端驱动以保证最好的兼容性,包括 Shell 套件、Java jar 包、PHP 扩展、Node.js 模块等,具体请参见 MongoDB 官网驱动介绍
不同语言连接示例。

常见问题

如果连接失败,请参见 无法连接 MongoDB 解决方法 逐一排查处理。更多问题,请参见 连接相关问题