如何在 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 就能自动完成嵌套数组的深度反序列化——无需手动遍历或额外解析，简洁、高效、可靠。