mgo/bson Unmarshal机制概述
在go语言中，mgo 是一个常用的mongodb驱动，它依赖 mgo/bson 包来处理go类型与bson（binary json）格式之间的数据转换。当我们使用 bson.unmarshal 函数将bson数据反序列化到一个go结构体实例时，一个常见的困惑是结构体中预先存在的非导出字段（unexported fields）会被重置为它们的零值。这种行为并非偶然，而是 mgo/bson 包内部设计的一部分。
深入解析非导出字段清零行为
mgo/bson 在执行 Unmarshal 操作时，其内部逻辑会明确地将目标结构体的所有字段（包括导出字段和非导出字段）首先设置为其对应的零值。例如，整数类型会被设置为 0，字符串类型会被设置为 ""，指针类型会被设置为 nil。完成这一初始化步骤后，它才会根据BSON数据中的键值对，尝试匹配并填充结构体中的导出字段。由于非导出字段不会从BSON数据中获取值（因为它们不可导出，无法被外部序列化器访问），因此它们会保留初始化时的零值。
这种设计理念是为了确保反序列化的结果只依赖于输入的BSON数据本身，而不受目标结构体在 Unmarshal 操作之前所持有的任何状态的影响。这提高了数据处理的可预测性和一致性，避免了因历史状态残留而导致的潜在错误。然而，这也意味着用户无法通过任何配置选项来禁用或修改这一行为。
示例代码与结果分析
以下是一个具体的Go语言示例，展示了 mgo/bson 的这一特性：
package main
import (
"fmt"
"labix.org/v2/mgo/bson" // 注意：这是mgo v2的包路径
)
// Sub 是一个嵌套结构体
type Sub struct{ Int int }
// Player 结构体包含导出字段和非导出字段
type Player struct {
Name string // 导出字段
unexpInt int // 非导出整数
unexpPoint *Sub // 非导出指针
}
func main() {
// 准备BSON数据，只包含Name字段
dta, err := bson.Marshal(bson.M{"name": "ANisus"})
if err != nil {
panic(err)
}
// 初始化Player实例，并给非导出字段赋初值
p := &Player{unexpInt: 12, unexpPoint: &Sub{42}}
fmt.Printf("Before Unmarshal: %+v\n", p)
// 执行反序列化操作
err = bson.Unmarshal(dta, p)
if err != nil {
panic(err)
}
fmt.Printf("After Unmarshal: %+v\n", p)
}运行上述代码，将得到如下输出：
Before Unmarshal: &{Name: unexpInt:12 unexpPoint:0xc0000140a0} // unexpPoint地址可能不同
After Unmarshal: &{Name:ANisus unexpInt:0 unexpPoint:} 从输出中可以清晰地看到：
- 在 Unmarshal 之前，p.unexpInt 的值为 12，p.unexpPoint 指向一个有效的 Sub 结构体实例。
- 在 Unmarshal 之后，p.Name 字段被成功填充为 "ANisus"。
- 然而，p.unexpInt 被重置为 0（整数的零值），p.unexpPoint 被重置为
（指针的零值）。这验证了非导出字段在反序列化过程中被清零的行为。
设计考量与应对策略
mgo/bson 的这种行为是其核心设计的一部分，旨在提供一个干净、可预测的反序列化过程。因此，我们无法直接阻止非导出字段被清零。然而，我们可以根据这一特性来调整我们的编程实践和结构体设计：
理解非导出字段的用途：非导出字段通常用于存储结构体的内部状态或缓存，这些状态不应直接暴露给外部序列化机制。如果某个字段的数据需要从MongoDB中加载或在反序列化后保持不变，那么它应该被设计为导出字段。
避免在非导出字段中存储关键持久化数据：如果一个非导出字段存储了在 Unmarshal 操作后仍需保留的关键数据，那么这种设计可能是不合适的。考虑将这类数据移至导出字段，或者将其作为独立的、不参与 bson.Unmarshal 的数据进行管理。
-
手动保存和恢复：如果确实需要在 Unmarshal 过程中保留某个非导出字段的值，唯一的办法是在 Unmarshal 之前手动保存该值，并在 Unmarshal 之后将其重新赋值给结构体。这会增加代码的复杂性，并且通常表明结构体设计可能需要重新评估。
// 示例：手动保存和恢复非导出字段 // ... (Player 结构体和 BSON 数据准备同上) ... p := &Player{unexpInt: 12, unexpPoint: &Sub{42}} // 保存非导出字段的当前值 savedUnexpInt := p.unexpInt savedUnexpPoint := p.unexpPoint // 注意：这里保存的是指针，如果需要深度拷贝，则需要额外处理 fmt.Printf("Before Unmarshal: %+v\n", p) err = bson.Unmarshal(dta, p) if err != nil { panic(err) } fmt.Printf("After Unmarshal (before restore): %+v\n", p) // 恢复非导出字段的值 p.unexpInt = savedUnexpInt p.unexpPoint = savedUnexpPoint fmt.Printf("After Unmarshal (after restore): %+v\n", p)这种方法虽然可行，但增加了维护成本，且可能引入新的错误（例如，如果 unexpPoint 指向的对象也需要深度拷贝而不是简单赋值指针）。
总结
mgo/bson 在反序列化时清零非导出字段是其设计中固有的行为，旨在保证数据来源的纯粹性和结果的可预测性。开发者在设计Go结构体以与MongoDB进行交互时，应充分理解这一机制。对于需要在反序列化后保留状态的字段，应将其设计为导出字段，或者通过外部管理、手动保存与恢复等方式来处理，避免依赖非导出字段在 Unmarshal 过程中保持其原有值。
