本文介绍在使用 mgo 驱动时，如何针对结构体指针字段（如 `*tool`）实现区别于值类型字段的自定义 bson 序列化逻辑，避免默认内联嵌套，转而仅存储引用 id。
在 MongoDB 的 Go 生态中，mgo（尽管已归档，但仍在许多遗留项目中广泛使用）默认将结构体值和结构体指针统一按内联方式序列化为嵌套 BSON 文档。这意味着如下结构：
type Tool struct { ID bson.ObjectId `bson:"_id,omitempty"` Name string `bson:"name"` } type Order struct { Item Tool `bson:"item"` AssociatedItem *Tool `bson:"associated_item"` // ❌ 默认仍会完整嵌入整个 Tool 文档 }即使 AssociatedItem 是 *Tool，mgo.Marshal() 仍会将其解引用后完整序列化为子文档，而非你期望的“仅存 ID 引用”。而 SetBSON() / GetBSON() 接口作用于类型层面（如 Tool），*无法区分 Tool 和 `Tool的序列化行为**——这是mgo` 类型系统的设计限制。
✅ 推荐方案：通过类型别名实现语义隔离
最简洁、无侵入、符合 Go 类型安全原则的方式是：为需特殊序列化的指针场景，定义独立的类型别名，并为其单独实现 SetBSON/GetBSON。
// 定义新类型，语义上表示“可选择性序列化的 Tool 引用” type SelectiveTool Tool // 实现 GetBSON：当作为 *SelectiveTool 字段时，只输出 ID（或自定义引用格式） func (st *SelectiveTool) GetBSON() (interface{}, error) { if st == nil { return nil, nil } return bson.M{"_id": (*Tool)(st).ID}, nil // 仅存 ObjectId } // 实现 SetBSON：从 BSON 反序列化时，仅解析 _id 并初始化空 Tool（或按需加载） func (st *SelectiveTool) SetBSON(raw bson.Raw) error { var m bson.M if err := raw.Unmarshal(&m); err != nil { return err } if id, ok := m["_id"]; ok { if oid, ok := id.(bson.ObjectId); ok { *st = SelectiveTool{ID: oid} // 仅恢复 ID，其他字段留空 } } return nil } // 更新 Order 结构体，明确使用新类型 type Order struct { Item Tool `bson:"item"` AssociatedItem *SelectiveTool `bson:"associated_item"` // ✅ 现在会触发自定义序列化 }⚠️ 注意事项与最佳实践
- 零值安全：*SelectiveTool 为 nil 时，GetBSON() 应返回 nil，mongodb 将存储 NULL，符合引用语义；
- 反序列化灵活性：SetBSON 中可根据实际需求扩展逻辑，例如：从 _id 加载完整 Tool（需额外 DB 查询），或仅缓存 ID 供后续懒加载；
- 避免循环依赖：若 SelectiveTool 需访问业务逻辑（如 DAO），建议通过组合而非嵌入传递依赖，保持类型纯净；
- 迁移兼容性：旧数据中若 associated_item 是完整嵌套文档，SetBSON 可增强容错逻辑（先尝试解析 _id，失败则 fallback 到完整 Tool 解析）；
- 替代方案对比：
- ❌ 使用 bson.ObjectId 字段：丢失类型信息与业务语义，需手动转换；
- ❌ 在 Order 中实现 GetBSON：破坏单一职责，且难以复用；
- ✅ 类型别名 + 自定义编组：语义清晰、可复用、零运行时开销、完全类型安全。
通过该模式，你能在保持代码可读性与类型安全的同时，精准控制指针字段的持久化形态——从“全量嵌套”转向“轻量引用”，为构建松耦合、可扩展的 MongoDB 数据模型奠定基础。