本文详细介绍了在Go语言中使用`mgo`（或`go.mongodb.org/mongo-driver`）操作MongoDB时，如何通过结构体标签`bson:"-"`来控制特定字段不被持久化到数据库。即使字段包含数据，此方法也能有效阻止其存储，同时保持字段在Go代码中的可访问性，解决了在数据模型中需要临时或计算字段但不希望其入库的场景。
为何需要排除结构体字段？
在Go语言开发中，当我们将结构体对象序列化并存储到MongoDB等文档型数据库时，通常希望结构体的所有公开字段都能被正确地映射并持久化。然而，在某些特定场景下，我们可能需要一个结构体字段仅用于Go应用程序内部的逻辑处理、临时存储或作为派生数据，而不希望它被写入数据库。
例如，一个用户结构体可能包含敏感信息（如社会安全号SSN），我们不希望直接存储它，而是只存储其哈希值。同时，为了方便在Go代码中处理，我们可能仍然希望SSN字段是公开的（首字母大写）。如果简单地将字段设为私有（首字母小写），虽然可以阻止其持久化，但这会限制其在Go代码中的直接访问，造成不便。
解决方案：bson:"-" 结构体标签
Go语言的MongoDB驱动（无论是旧版mgo还是新版go.mongodb.org/mongo-driver）都支持通过结构体标签（struct tags）来控制字段的序列化和反序列化行为。要实现字段的排除，最直接且推荐的方法是使用bson:"-"标签。
立即学习“go语言免费学习笔记（深入）”；
这个标签明确告诉BSON编码器（负责将Go结构体转换为BSON格式以存储到MongoDB）和BSON解码器（负责将BSON数据转换为Go结构体），在处理该字段时应将其完全忽略。这意味着：
- 持久化时： 带有bson:"-"标签的字段不会被写入MongoDB。
- 读取时： 从MongoDB读取数据并反序列化到Go结构体时，该字段会保持其Go语言默认值（例如，字符串为空字符串，整数为0，指针为nil），而不会从数据库中查找对应的值。
实战示例
以下示例演示了如何在Go语言中使用mgo库，通过bson:"-"标签阻止Person结构体中的SSN字段被持久化到MongoDB。
package main
import (
"crypto/sha1"
"encoding/base64"
"fmt"
"log"
"gopkg.in/mgo.v2" // 推荐使用 gopkg.in/mgo.v2
"gopkg.in/mgo.v2/bson" // 导入 bson 包
)
// Person 结构体定义，演示如何使用 bson:"-" 标签排除字段
type Person struct {
ID bson.ObjectId `bson:"_id,omitempty"` // MongoDB _id 字段，通常由驱动自动生成
Name string `bson:"name"`
SSN string `bson:"-"` // 使用 bson:"-" 标签，此字段将不会被持久化到MongoDB
HashedSSN string `bson:"hashedSSN"`
}
func main() {
// 1. 初始化 Person 对象
bob := Person{
ID: bson.NewObjectId(), // 手动生成一个ID，或让MongoDB自动生成
Name: "Bob",
SSN: "fake_ssn_12345", // 这个字段包含数据，但不会被持久化
HashedSSN: "",
}
// 2. 计算 HashedSSN
hasher := sha1.New()
hasher.Write([]byte(bob.SSN))
sha := base64.URLEncoding.EncodeToString(hasher.Sum(nil))
bob.HashedSSN = sha
fmt.Printf("准备插入数据（SSN字段不会被持久化）：%+v\n", bob)
// 3. 连接 MongoDB
// 请确保本地 MongoDB 实例正在运行
mgoSession, err := mgo.Dial("mongodb://localhost:27017")
if err != nil {
log.Fatalf("无法连接到 MongoDB: %v", err)
}
defer mgoSession.Close() // 确保会话在程序结束时关闭
// 设置读写一致性，确保数据写入后立即可读
mgoSession.SetMode(mgo.Monotonic, true)
// 4. 获取集合并插入数据
c := mgoSession.DB("testdb").C("person") // 使用一个明确的数据库名和集合名
err = c.Insert(bob)
if err != nil {
log.Fatalf("插入数据失败: %v", err)
}
fmt.Println("数据插入成功！")
// 5. 验证数据：从数据库中读取并检查 SSN 字段是否被排除
var result Person
err = c.Find(bson.M{"name": "Bob"}).One(&result) // 使用 bson.M 进行查询
if err != nil {
log.Fatalf("查询数据失败: %v", err)
}
fmt.Printf("从数据库中读取到的数据: %+v\n", result)
// 预期：result.SSN 应该是其默认值（空字符串），因为我们将其排除在持久化之外
if result.SSN == "" {
fmt.Println("验证成功：SSN 字段未被持久化到数据库。")
} else {
fmt.Printf("验证失败：SSN 字段意外地被持久化：%s\n", result.SSN)
}
// 6. （可选）清理数据
// _, err = c.RemoveAll(bson.M{"name": "Bob"})
// if err != nil {
// log.Printf("清理数据失败: %v", err)
// } else {
// fmt.Println("数据清理成功。")
// }
}运行上述代码并检查MongoDB： 你会在testdb数据库的person集合中发现一个文档，其中只包含_id、name和hashedSSN字段，而SSN字段不会出现在文档中。这证明了bson:"-"标签的有效性。
深入理解与注意事项
- mgo与go.mongodb.org/mongo-driver： 示例中使用的是gopkg.in/mgo.v2，它是社区维护的mgo分支，兼容性较好。对于新项目，官方推荐使用go.mongodb.org/mongo-driver。这两种驱动都支持bson:"-"标签，用法基本一致。
-
其他bson标签：
- bson:"fieldName"：将Go结构体字段映射到MongoDB中的不同字段名。例如，Name stringbson:"full_name"``。
- bson:",omitempty"：如果字段为空值（零值），则在持久化时省略该字段。这与bson:"-"不同，bson:"-"是无论是否有值都始终省略。
- bson:",inline"：将内嵌结构体的字段提升到父文档的顶层。
- Go字段可见性： Go语言中，首字母大写的字段是公开的，首字母小写的字段是私有的。私有字段默认不会被mgo或mongo-driver持久化。但使用bson:"-"的优势在于，它允许字段保持公开，方便Go代码访问，同时仍能控制其持久化行为。
- 反序列化行为： 当从MongoDB读取数据时，如果数据库中存在一个字段，但对应的Go结构体字段带有bson:"-"标签，那么数据库中的该字段会被忽略，Go结构体中的字段将保持其默认零值。
- 性能考虑： 使用bson:"-"通常不会带来显著的性能开销，因为它只是在序列化/反序列化过程中跳过特定字段的处理。
总结
通过在Go结构体字段上使用bson:"-"标签，开发者可以精确控制哪些字段应该被持久化到MongoDB，哪些应该仅在应用程序内部使用。这种机制在处理敏感数据、派生数据或临时字段时非常有用，它在保持Go代码可读性和可维护性的同时，提供了灵活的数据存储策略。掌握这一技巧是使用Go语言与MongoDB进行高效开发的关键一步。
