如何在 Go 中完整获取 MongoDB 文档中的数组字段（含嵌套结构）_技术教程

本文详解如何使用 go 官方 mongodb 驱动（mongo-go-driver）准确查询并反序列化包含嵌套数组的 mongodb 文档，以完整获取如 `region` 这类数组字段及其全部元素。

在 Go 中操作 MongoDB 时，若需完整提取文档中某个数组字段（例如 region），关键在于：正确建模数据结构 + 使用强类型反序列化 + 选择合适的驱动版本。值得注意的是，原问题中示例代码使用的是已归档的 mgo 库（gopkg.in/mgo.v2），而当前官方推荐且持续维护的驱动是 MongoDB Go Driver（go.mongodb.org/mongo-driver/mongo）。以下教程基于该现代驱动实现，兼顾兼容性、安全性与可维护性。

✅ 正确建模嵌套数组结构

首先，根据你的文档结构定义 Go 结构体，并为每个字段添加 bson 标签（用于 BSON 解码）和 json 标签（用于后续 JSON 输出）：

type City struct {
    ID     ObjectID `bson:"_id" json:"-"` // _id 是 ObjectId 类型，输出时通常忽略
    Name   string   `bson:"City" json:"City"`
    Region []Place  `bson:"region" json:"region"`
}

type Place struct {
    RegionID  string `bson:"regionid" json:"regionid"`
    HistPlace string `bson:"historical_place" json:"historical_place"`
}

⚠️ 注意：ObjectID 来自 go.mongodb.org/mongo-driver/bson/primitive，需显式导入；json:"-" 表示该字段不参与 JSON 序列化，避免 _id 以原始 ObjectId 字符串形式暴露。

✅ 使用官方驱动查询并反序列化整个数组

以下是完整可运行示例（Go 1.18+，MongoDB Driver v1.14+）：

package main

import (
    "context"
    "encoding/json"
    "fmt"
    "log"
    "time"

    "go.mongodb.org/mongo-driver/bson"
    "go.mongodb.org/mongo-driver/bson/primitive"
    "go.mongodb.org/mongo-driver/mongo"
    "go.mongodb.org/mongo-driver/mongo/options"
    "go.mongodb.org/mongo-driver/mongo/readpref"
)

type City struct {
    ID     primitive.ObjectID `bson:"_id" json:"-"`
    Name   string             `bson:"City" json:"City"`
    Region []Place            `bson:"region" json:"region"`
}

type Place struct {
    RegionID  string `bson:"regionid" json:"regionid"`
    HistPlace string `bson:"historical_place" json:"historical_place"`
}

func main() {
    // 建立连接（建议使用 context 控制超时）
    ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
    defer cancel()

    client, err := mongo.Connect(ctx, options.Client().ApplyURI("mongodb://127.0.0.1:27017"))
    if err != nil {
        log.Fatal("Failed to connect to MongoDB:", err)
    }
    defer func() {
        if err = client.Disconnect(ctx); err != nil {
            log.Fatal("Failed to disconnect:", err)
        }
    }()

    // 获取集合
    collection := client.Database("db").Collection("myplace")

    // 查询所有文档（可替换为带 filter 的查询，如 bson.M{"City": "some city"}）
    cursor, err := collection.Find(ctx, bson.M{})
    if err != nil {
        log.Fatal("Find failed:", err)
    }
    defer cursor.Close(ctx)

    var cities []City
    if err = cursor.All(ctx, &cities); err != nil {
        log.Fatal("Decode failed:", err)
    }

    // 格式化 JSON 输出（符合预期结构）
    out, err := json.MarshalIndent(cities, "", "  ")
    if err != nil {
        log.Fatal("JSON marshal failed:", err)
    }

    fmt.Println("Result:")
    fmt.Println(string(out))
}

✅ 关键要点说明

不要用 map[string]interface{} 临时解包：虽可行，但丧失类型安全与 IDE 支持，难以维护。
Find(nil) → Find(ctx, bson.M{})：新驱动强制要求传入 context.Context 和 bson.D / bson.M 查询条件。
cursor.All() 替代 Find().All()：更明确地表达“将游标中所有结果批量解码到切片”。
错误处理不可省略：尤其是网络 I/O 和 BSON 解码错误，应逐层检查。
primitive.ObjectID 是标准类型：务必使用 primitive.ObjectIDHex() 解析字符串 ID，或用 primitive.NewObjectID() 生成新 ID。

✅ 输出效果（与预期一致）

运行后将输出如下格式化 JSON（已去除 _id 字段，仅保留 City 和完整 region 数组）：

[
  {
    "City": "some city",
    "region": [
      {
        "regionid": "31",
        "historical_place": "temple"
      },
      {
        "regionid": "32",
        "historical_place": "temple"
      },
      {
        "regionid": "33",
        "historical_place": "temple"
      }
    ]
  }
]

✅ 总结：只要结构体标签与数据库字段名严格对应（注意大小写与下划线转换），Go 就能自动完成嵌套数组的深度反序列化——无需手动遍历或额外解析，简洁、高效、可靠。