Go调用MongoDB FindOne报cursor should be an embedded document错误如何解决

错误根因 #

该报错由MongoDB连接串格式错误导致。你当前使用的mongodb://<IP>:<PORT>/<cluster_name>格式不符合URI规范：连接URI的路径位默认代表要连接的数据库名称，如果你将集群名放在路径位，Go驱动会将该值作为无效参数传递给服务端，导致返回的响应结构无法被正确解析，触发cursor should be an embedded document but is of BSON type invalid报错。

修复方案 #

• 第一步：修正连接串格式
  • 单节点实例连接格式：mongodb://<IP>:<PORT>/<实际数据库名>?directConnection=true，不要在路径位填写集群名
  • 副本集/分片集群连接格式：mongodb://<节点1地址>:<端口>,<节点2地址>:<端口>/<实际数据库名>?replicaSet=<集群名>，集群名通过replicaSet参数传递，不要放在路径位
• 第二步：升级Mongo Go驱动到最新稳定版，低版本驱动存在同类响应解析bug，执行以下命令升级：
  go get go.mongodb.org/mongo-driver@latest
• 第三步：补充Decode逻辑验证查询结果，参考代码：

ctx, cancel := store.GetCtx()
defer cancel()
collection := store.GetConn().Collection("collection")
cursor := collection.FindOne(
    ctx,
    bson.M{},
)

if cursor.Err() != nil {
    fmt.Println(cursor.Err().Error()) 
    return
}
// 新增解码逻辑
var res bson.M
if err := cursor.Decode(&res); err != nil {
    fmt.Println("解码失败：", err)
    return
}
fmt.Println("查询成功，结果：", res)

可选排查项 #

如果修正后仍有问题，可以排查：

• 确认导入的bson包为官方包go.mongodb.org/mongo-driver/bson，不要使用第三方不兼容的bson实现
• 确认VPN没有拦截或篡改27017端口的TCP流量，可尝试在无VPN环境测试连接

内容的提问来源于stack exchange，提问作者blmayer