必须显式指定replicaSet参数,否则mongo-go-driver以单节点模式连接,不支持副本集发现与故障转移,写操作报“not master”错误;URI需逗号分隔多节点、无空格、正确URL编码,并配TLS证书及readPreference等参数。

Go 连接副本集必须带 replicaSet 参数
不加这个参数,mongo-go-driver 会当作单节点连接,即使你传了多个 host,它也不会做副本集发现和主备切换。现象是:写操作报 not master 错误,或连接后立刻断开。
正确写法是把所有节点地址用逗号拼进 URI,并显式指定 replicaSet 名称:
mongodb://user:pass@11.11.11.11:27017,22.22.22.22:27017,33.33.33.33:27017/admin?replicaSet=rs0&authSource=admin
-
admin是认证数据库名,必须和创建用户时的db字段一致 - 多个 host 地址之间**不能有空格**,否则解析失败
- 如果用户名/密码含
@、:、/等字符,必须 URL 编码(例如@→%40)
启用 TLS 加密要设 ssl=true 并配证书路径
仅在 URI 里加 ssl=true 不够,驱动默认不校验服务端证书;生产环境必须提供 CA 文件路径,否则连接会被拒绝或降级为不安全通信。
推荐做法是在 options.Client() 中单独配置 TLS:
立即学习“go语言免费学习笔记(深入)”;
opts := options.Client().ApplyURI(uri).
SetTLSConfig(&tls.Config{
RootCAs: x509.NewCertPool(),
// 加载 /etc/ssl/ca.pem 内容到 RootCAs
})
- 不要用
insecureSkipVerify: true,这等于关掉证书验证 - 若用自签名证书,需手动将 CA 文件内容加载进
RootCAs,不能只靠文件路径 - URI 中的
ssl=true和代码中SetTLSConfig要同时存在,缺一不可
KeyFile 鉴权对 Go 客户端完全透明
keyFile 是副本集节点间通信的凭证,Go 应用**不需要也不应该**在连接串或代码里提供它。只要 MongoDB 服务端已用 --keyFile 启动且各节点同步了同一份密钥文件,客户端只需正常认证即可。
- 错误做法:试图把 keyFile 内容塞进 URI 或 header —— 驱动根本不识别
- 常见坑:服务端没配 keyFile 或权限不是
400,导致副本集初始化失败,此时 Go 连接会卡在server selection timeout - 验证方式:连上后执行
rs.status(),看members[n].stateStr是否全为PRIMARY/SECONDARY,而非STARTUP2或REMOVED
读写分离和故障转移依赖 readPreference 和重试配置
默认 readPreference=primary,所有读也走主节点。要分担压力,必须显式设置,且搭配 retryWrites=true 才能在主切后自动重试写操作。
生产推荐配置:
opts := options.Client().ApplyURI(uri).
SetReadPreference(readpref.SecondaryPreferred()).
SetWriteConcern(writeconcern.New(writeconcern.WMajority())).
SetRetryWrites(true).
SetRetryReads(true)
-
SecondaryPreferred表示优先读从节点,主节点不可用时退化为读主节点 -
w=majority防止网络分区时数据丢失,但会略微增加写延迟 - 不设
connectTimeoutMS和socketTimeoutMS容易在节点宕机时卡住整个 goroutine


















