哎呀，最近在弄 mgo 这个数据库东西，感觉头都大了。特别是在处理结构体指针的时候，简直是噩梦！默认就是把整个东西都塞进去，一点都不灵活。今天就来跟大家分享一下我摸索出来的一个小技巧，保证让你少走点弯路。别看它很简单，但真的很有用！

啥情况？为什么这么麻烦？

先说说咱们得明白一个问题：在 MongoDB 的 Go 生态系统中，mgo 这个驱动默认会把你的 Go 结构体值和指针值都当成一个大块的嵌套文档来序列化。也就是说 如果你有一个 `Tool` 类型，然后你有一个 `Order` 类型，里面包含一个 `Tool` 类型和一个指向 `Tool` 类型值的指针 `AssociatedItem`，官宣。。

type Tool struct {
    ID    `bson:"_id,omitempty"` // 这个是 ObjectId
    Name string        `bson:"name"`
}
type Order struct {
    Item           Tool   `bson:"item"`  // 这儿是直接嵌入 Tool 对象了！好麻烦！
    AssociatedItem *Tool  `bson:"associated_item"` //  这个是指针啊！但是...还是不行啊！

你看上面这个代码， 即使 `AssociatedItem` 是一个指针类型 ，mgo 默认情况下还是会把整个 `Tool` 对象都嵌入到 BSON 文档里。 与君共勉。 这简直就是浪费空间啊！而且如果 `AssociatedItem` 是 nil 的话，也会产生不必要的文档。

更糟糕的情况

更坑爹的是SetBSON 和 GetBSON 方法作用于类型层面。这意味着你不能区分是不是要处理的是普通的 `Tool` 对象还是 `*Tool` 指针。这导致你很难实现只存储 ID 的序列化逻辑。

解决方案：自定义序列化 – 就是要搞个新的类型别名

为了解决这个问题， 我找到了一种比较简洁、比较靠谱的方法：**定义一个新的类型别名**。这样就可以针对这个新类型实现自定义的序列化逻辑了，盘它。。

咱们用一个例子

type SelectiveTool Tool  // 定义一个新的类型 SelectiveTool , 代表可选的 Tool 引用
func  GetBSON  { // 实现 GetBSON 方法 , 只输出 ID 。注意 st 是一个指针! 注意细节哦! 可以看到我们先判断 st 是否为 nil. 如果是nil直接返回nil 然后返回 _id. 我们必须确保 st 是非 nil 的否则 会 panic 。这是最简单的处理方法.当然可以写得复杂一些.
    if st == nil {
        return nil, nil
    }
    return mapinterface{}{"_id": st.ID}, nil //只保存 _id
}
func  SetBSON error {   //实现 SetBSON 方法 , 从 BSON 反序列化时 , 只解析 _id 并初始化空 Tool
    var m mapinterface{}
    if err := json.Unmarshal, &m); err != nil {
        return err
    }
    if id, ok := m; ok {
        if oid, ok := id.; ok {
            tool := SelectiveTool{ID: oid}
            *st = tool
        }
    }
    return nil
}
type Order struct {
    Item           Tool          `bson:"item"`
    AssociatedItem *SelectiveTool `bson:"associated_item"` // 现在会触发自定义序列化! 重要的事情说三遍!
}

代码解释一下

• SelectiveTool 类型我们定义了一个新的类型别名 `SelectiveTool` ，它其实吧是一个指向 `Tool` 类型的值的指针 。
• GetBSON 方法这个方法负责将我们的 `SelectiveTool` 对象序列化成 BSON 文档。这里我们只返回了它的 ID ，其他字段都忽略了。
• SetBSON 方法这个方法负责从 BSON 文档反序列化数据到我们的 `SelectiveTool` 对象。同样地，我们只解析了 ID ，然后将它赋给新的 `SelectiveTool`。

⚠️ 注意事项与最佳实践

• 零值平安在 GetBSON 中需要处理กรณี st 为 nil 的情况 ，否则会导致 panic 。MongoDB 将存储 null ， 符合引用语义；
• 反序列化灵活性SetBSON 中可根据实际需求 逻辑 ，比方说从 _id 加载完整 Tool 或者仅缓存 ID 用于后续懒加载；
• 避免循环依赖如果 SelectiveTool 需要访问业务逻辑 ，建议通过组合而不是嵌入传递依赖 ，保持类型纯净；
• 迁移兼容性旧数据中如果 associated_item 是完整嵌套文档 ，SetBSON 可以增强容错逻辑；
• 替代方案对比:
  • ❌ 使用字段:丢失类型信息与业务语义 ，需要手动转换;
  • ❌ 在 Order 中实现 GetBSON:破坏单一职责 ，且难以复用;
  • ✅ 类型别名 + 自定义编组:语义清晰 、可复用 、零运行时开销 、完全类型平安;

物超所值。 通过这种方式 ，你可以精准控制 Pointer字段的持久化形态 —— 从“全量嵌套”转向“轻量引用” 。这种方式不仅能节省空间 ，还能提高代码的可读性和可维护性 。

最简洁的方式是什么？

我满足了。 是最简洁、无侵入、符合 Go 类型平安原则的方式。

希望这篇文章能帮助到你 ！ 如果觉得有用的话 , 点赞收藏一下吧 ！