本文详解如何使用 mgo（v2）驱动在 go 中构造 mongodb 的 `$or` 逻辑查询，包括语法结构、完整可运行示例及常见注意事项。

在 MongoDB 的 Go 生态中，mgo（虽已归档但仍在广泛维护的 v2 分支）是早期最常用的驱动之一。其查询语法高度贴近原生 BSON 表达，但初学者易在嵌套结构上出错。核心要点在于：$or 接收一个文档数组（[]bson.M），每个元素均为独立的查询条件（bson.M），且各条件之间为逻辑“或”关系。

✅ 正确语法结构如下：

bson.M{
    "$or": []bson.M{
        bson.M{"uuid": "some-uuid"},
        bson.M{"name": "John"},
        bson.M{"email": bson.M{"$regex": "^test@.*\\.com$"}},
    },
}

⚠️ 常见错误包括：

• 将 []bson.M 误写为 []interface{} 或 []map[string]interface{}（类型不匹配，mgo 无法序列化）；
• 混淆 $or 与 $in：$in 用于单字段匹配多个值（如 {"status": {"$in": ["active", "pending"]}}），而 $or 用于跨字段的多条件组合；
• 忘记导入 "gopkg.in/mgo.v2/bson"（仅导入 mgo 不够，bson.M 定义在此包中）。

以下是一个完整、可直接运行的示例（兼容 Go 1.4+ 和 MongoDB 2.6+）：

package main

import (
    "fmt"
    "log"
    "gopkg.in/mgo.v2"
    "gopkg.in/mgo.v2/bson"
)

type Person struct {
    Num  int    `bson:"num"`
    Uuid string `bson:"uuid"`
    Name string `bson:"name"`
}

func main() {
    session, err := mgo.Dial("localhost:27017")
    if err != nil {
        panic(err)
    }
    defer session.Close()

    c := session.DB("test").C("people")
    // 清理测试环境
    c.DropCollection()

    // 插入测试数据
    if err = c.Insert(
        &Person{1, "UUID1", "Joe"},
        &Person{2, "UUID2", "Jane"},
        &Person{3, "UUID3", "Didier"},
    ); err != nil {
        log.Fatal(err)
    }

    // 构造 $or 查询：查找 uuid="UUID0" OR name="Joe"
    query := bson.M{
        "$or": []bson.M{
            bson.M{"uuid": "UUID0"},
            bson.M{"name": "Joe"},
        },
    }

    var result Person
    if err = c.Find(query).One(&result); err != nil {
        log.Printf("No match found (expected for UUID0): %v", err)
        // 注意：此处因 UUID0 不存在，会返回 mgo.ErrNotFound，属正常行为
        return
    }
    fmt.Printf("Found: %+v\n", result) // 输出: Found: {Num:1 Uuid:"UUID1" Name:"Joe"}
}

? 关键提示：

• 若需查询全部匹配项，用 All(&[]Person{}) 替代 One(&Person{})；
• 在生产环境中，建议对 c.Find() 加 .Sort()、.Limit() 或 .Select() 优化性能；
• mgo 已不再积极维护，新项目推荐迁移到官方驱动 mongo-go-driver，其 $or 写法为 bson.D{{"$or", bson.A{bson.D{{"uuid", "x"}}, bson.D{{"name", "y"}}}}}，语义一致但类型更严格。

掌握 $or 的正确构造方式，是编写灵活、高效 MongoDB 查询的基础能力——它让“任一条件满足即命中”的业务逻辑（如多字段模糊搜索、复合权限校验）得以简洁实现。