本文详细介绍了在go语言中使用`mgo`驱动时，如何优雅地阻止特定结构体字段被持久化到mongodb数据库，即使这些字段不为空。通过引入`bson:"-"`结构体标签，本文提供了一种简洁高效的解决方案，避免了诸如将字段名改为小写等不便的替代方法，从而确保代码清晰性和数据处理的灵活性。
理解Go结构体与MongoDB的映射机制
在Go语言中，当我们使用像mgo这样的MongoDB驱动与数据库交互时，Go结构体（Struct）通常被用来定义文档的模式。驱动程序会自动将Go结构体的公开字段（即首字母大写的字段）映射到MongoDB文档的BSON字段。默认情况下，所有公开且非零值的字段都会被序列化并存储到数据库中。
然而，在实际开发中，我们经常会遇到这样的场景：结构体中包含一些用于业务逻辑处理的字段，这些字段可能存储着敏感信息或临时数据，它们参与计算但绝不应该被持久化到数据库中。例如，一个Person结构体可能包含一个用于计算哈希值的原始SSN（社会安全号码）字段，但我们只希望将SSN的哈希值存储到数据库，而原始SSN则不应被保存。
挑战：如何选择性地忽略字段？
传统的Go语言私有字段（首字母小写的字段）确实不会被mgo序列化。但对于需要保持公开可见性（例如，为了在Go代码中方便访问或进行其他处理）的字段，这种方法就显得力不从心了。如果为了不持久化而将字段名改为小写，会使得该字段在Go语言包外部无法直接访问，降低了代码的可用性和可读性。
解决方案：使用bson:"-"结构体标签
mgo（以及更现代的go.mongodb.org/mongo-driver）提供了一种强大且灵活的机制来控制结构体字段与BSON文档之间的映射：结构体标签（Struct Tags）。对于需要完全忽略，不进行任何序列化和反序列化的字段，我们可以使用bson:"-"标签。
立即学习“go语言免费学习笔记（深入）”；
这个标签告诉BSON编解码器：在将Go结构体转换为BSON文档时，完全跳过带有此标签的字段；同样，在将BSON文档反序列化为Go结构体时，也忽略BSON中对应字段的值。
示例：忽略敏感字段
让我们通过一个具体的例子来演示如何使用bson:"-"标签。假设我们有一个Person结构体，其中包含Name、SSN和HashedSSN字段。我们的目标是只存储Name和HashedSSN，而SSN字段即使有值，也不应被写入MongoDB。
package main
import (
"crypto/sha1"
"encoding/base64"
"fmt"
"log"
"time"
"gopkg.in/mgo.v2" // 注意：mgo是较旧的驱动，推荐使用go.mongodb.org/mongo-driver
"gopkg.in/mgo.v2/bson"
)
// Person 结构体定义
type Person struct {
ID bson.ObjectId `bson:"_id,omitempty"` // MongoDB文档ID
Name string `bson:"name"` // 存储姓名
SSN string `bson:"-"` // 使用bson:"-"标签，此字段将不被持久化
HashedSSN string `bson:"hashedSSN"` // 存储SSN的哈希值
CreatedAt time.Time `bson:"createdAt"` // 记录创建时间
}
func main() {
// 连接MongoDB
session, err := mgo.Dial("localhost:27017")
if err != nil {
log.Fatalf("无法连接MongoDB: %v", err)
}
defer session.Close() // 确保会话关闭
// 设置会话模式，确保读写一致性
session.SetMode(mgo.Monotonic, true)
// 获取数据库和集合
c := session.DB("testdb").C("people")
// 准备一个Person实例
bob := Person{
ID: bson.NewObjectId(),
Name: "Bob",
SSN: "fake_ssn_12345", // 这是一个不应被存储的敏感字段
CreatedAt: time.Now(),
}
// 计算SSN的哈希值并赋值给HashedSSN
hasher := sha1.New()
hasher.Write([]byte(bob.SSN))
bob.HashedSSN = base64.URLEncoding.EncodeToString(hasher.Sum(nil))
fmt.Printf("准备插入的Person对象（Go内存中）： %+v\n", bob)
// 插入文档
err = c.Insert(bob)
if err != nil {
log.Fatalf("插入文档失败: %v", err)
}
fmt.Println("文档插入成功。")
// 从数据库中查询该文档，验证SSN是否被忽略
var result Person
err = c.FindId(bob.ID).One(&result)
if err != nil {
log.Fatalf("查询文档失败: %v", err)
}
fmt.Printf("从MongoDB查询到的Person对象： %+v\n", result)
// 验证SSN字段是否为空（因为它没有被持久化）
if result.SSN == "" {
fmt.Println("验证成功：SSN字段未被持久化到数据库中。")
} else {
fmt.Printf("验证失败：SSN字段意外地被持久化，值为: %s\n", result.SSN)
}
// 进一步验证，可以查询原始BSON数据
var rawBSON map[string]interface{}
err = c.FindId(bob.ID).One(&rawBSON)
if err != nil {
log.Fatalf("查询原始BSON失败: %v", err)
}
fmt.Printf("从MongoDB查询到的原始BSON数据： %+v\n", rawBSON)
if _, ok := rawBSON["ssn"]; !ok {
fmt.Println("验证成功：原始BSON数据中不包含'ssn'字段。")
} else {
fmt.Println("验证失败：原始BSON数据中包含'ssn'字段。")
}
}运行上述代码，你将看到以下关键输出：
- 准备插入的Person对象（Go内存中）： 会显示SSN:fake_ssn_12345。
- 从MongoDB查询到的Person对象： 会显示SSN: (空字符串)，因为mgo在反序列化时也忽略了该字段。
- 验证成功：SSN字段未被持久化到数据库中。
- 从MongoDB查询到的原始BSON数据： 会显示不包含ssn键的BSON结构，进一步证实了字段被完全忽略。
注意事项与最佳实践
- 字段可见性与bson:"-": bson:"-"标签主要用于控制Go结构体中公开字段的持久化行为。对于私有字段（首字母小写），它们本身就不会被mgo序列化到MongoDB，因此无需使用此标签。
- 与其他BSON标签的优先级: bson:"-"标签具有最高优先级。这意味着即使你同时指定了bson:"fieldName"（用于字段重命名）或bson:",omitempty"（用于空值忽略），bson:"-"也会使其失效，该字段将完全被忽略。
- 数据安全考量: bson:"-"提供的是客户端层面的数据持久化控制。它确保了你的Go应用不会将特定字段写入MongoDB。然而，这并不能替代数据库层面的安全措施，如访问控制、字段级加密、审计日志等。对于高度敏感的数据，应综合运用多种安全策略。
- 驱动版本选择: 示例代码使用了gopkg.in/mgo.v2，这是一个功能强大但已不再积极维护的MongoDB Go驱动。官方推荐的Go驱动是go.mongodb.org/mongo-driver。尽管驱动不同，但bson:"-"这样的结构体标签原理和用法在两个驱动中是通用的。
- 反序列化行为: 当你从MongoDB查询文档并将其反序列化到带有bson:"-"标签的Go结构体时，即使数据库中存在一个同名字段（这通常不会发生，因为你不会写入它），该字段的值也不会被填充到Go结构体的对应字段中。Go结构体的该字段将保持其默认零值（例如，字符串为空，整数为0）。
总结
通过在Go结构体字段上使用bson:"-"标签，我们可以非常方便且优雅地控制哪些字段应该被持久化到MongoDB，哪些应该被忽略。这种方法不仅避免了修改字段可见性带来的不便，还提高了代码的可读性和维护性，是处理特定字段不应存储到数据库场景下的首选方案。在实际开发中，合理利用结构体标签能够使Go语言与MongoDB的集成更加灵活高效。
