本文详解 go 使用 mgo 驱动连接远程 mongodb 时出现 “authentication failed” 错误的成因与解决方案，重点介绍使用 mgo.dialwithinfo 显式配置认证参数的可靠方式，并提供可直接运行的完整示例。
本文详解 go 使用 mgo 驱动连接远程 mongodb 时出现 “authentication failed” 错误的成因与解决方案，重点介绍使用 mgo.dialwithinfo 显式配置认证参数的可靠方式，并提供可直接运行的完整示例。
在 Go 中通过 mgo 连接远程 MongoDB（如 MongoDB Atlas、MongoDB Cloud 或旧版 MongoLab/MongoDB+）时，常见的 server returned error on SASL authentication step: Authentication failed 错误，绝大多数并非驱动或协议问题，而是连接字符串或认证配置不匹配所致。尤其当使用形如 mongodb://user:pass@host:port/db 的 URI 方式时，mgo.v2 对 URI 解析存在限制：它不会自动将用户名/密码关联到目标数据库（auth source），而现代 MongoDB 默认要求在 admin 数据库或指定的 authSource 中进行认证。
原始代码中：
session, err := mgo.Dial("mongodb://<dbuser>:<dbpassword>@ds041154.mongolab.com:41154/location")该 URI 将 location 视为操作数据库，但未声明认证凭据应作用于哪个数据库（例如 admin）。若服务端配置为在 admin 库认证，而客户端未显式指定，则 SASL 流程必然失败。
✅ 正确做法是弃用简单 URI 连接，改用 mgo.DialWithInfo 构造结构化连接信息，明确指定 Username、Password 和 Database（此处 Database 指认证源数据库，即 authSource），并设置合理超时：
package main
import (
"fmt"
"log"
"time"
"gopkg.in/mgo.v2"
"gopkg.in/mgo.v2/bson"
)
const (
hosts = "ds026491.mongolab.com:26491" // 替换为你的实际地址
database = "messagingdb" // 你的业务数据库名
authDB = "admin" // 认证源数据库（通常为 admin）
username = "admin" // 用户名（确保有对应权限）
password = "youPassword" // 密码（注意 URL 编码特殊字符）
collection = "messages"
)
func main() {
info := &mgo.DialInfo{
Addrs: []string{hosts},
Timeout: 60 * time.Second,
Database: authDB, // ⚠️ 关键：指定 authSource，而非业务库
Username: username,
Password: password,
}
session, err := mgo.DialWithInfo(info)
if err != nil {
log.Fatalf("Failed to connect to MongoDB: %v", err)
}
defer session.Close() // 始终记得关闭会话
// 切换到业务数据库和集合
col := session.DB(database).C(collection)
// 示例：插入一条文档
doc := bson.M{"message": "Hello from Go!", "timestamp": time.Now()}
if err := col.Insert(doc); err != nil {
log.Fatalf("Insert failed: %v", err)
}
// 示例：查询计数
count, err := col.Count()
if err != nil {
log.Fatalf("Count failed: %v", err)
}
fmt.Printf("Total documents in '%s.%s': %d\n", database, collection, count)
}? 关键注意事项：
- DialInfo.Database 是 authSource，不是业务数据库：它告诉 MongoDB “去哪个库验证这个用户”，必须与服务端用户创建时指定的 authDB 一致（如 db.createUser(..., {roles: [...], pwd: "...", mechanisms: ["SCRAM-SHA-1"]}) 时所在的库）。
- 密码需 URL 编码：若密码含 @, /, : 等特殊字符，必须使用 url.PathEscape 或 url.QueryEscape 处理，否则解析失败。
- mgo.v2 已归档，生产环境建议迁移：mgo 官方已停止维护，推荐升级至官方驱动 go.mongodb.org/mongo-driver/mongo，其对连接字符串、认证机制（如 SCRAM-SHA-256）、TLS 等支持更完善。
- 网络与权限检查：确保远程 MongoDB 实例允许你的 IP 访问（白名单），且该用户对目标数据库拥有 readWrite 或更高权限。
总结：SASL 认证失败本质是“凭证无法被验证”，根源在于认证上下文（authSource）缺失或错误。通过 DialWithInfo 显式控制认证参数，是最稳定、最可控的连接方式，也是调试认证问题的首选实践。
