本文将详细介绍在go语言中使用mgo或mongodb官方驱动时，如何通过结构体标签（bson:"-"）来控制字段的持久化行为。即使字段包含数据且为导出字段，也能有效阻止其被写入mongodb数据库，从而实现灵活的数据存储策略，避免不必要的数据泄露或存储。
引言：Go结构体字段与MongoDB持久化
在Go语言开发中，当我们将结构体对象存储到MongoDB数据库时，通常会使用mgo库（较早的项目）或go.mongodb.org/mongo-driver（官方推荐的现代驱动）。默认情况下，Go结构体中所有导出的（即首字母大写的）字段都会被序列化并存储到MongoDB中。然而，在实际应用中，我们经常会遇到这样的需求：某些字段需要在Go程序内部使用和处理（因此需要是导出字段），但不希望它们被持久化到数据库中，即使它们不为空。
例如，一个Person结构体可能包含敏感信息如社会安全号码（SSN），我们可能只希望将SSN的哈希值存储到数据库，而原始SSN只在内存中处理。如果将SSN字段设为小写（非导出字段），虽然可以阻止其被序列化，但这会限制其在其他包中的访问和使用，带来不便。
核心解决方案：BSON标签 bson:"-"
Go语言的encoding/json、encoding/xml以及MongoDB驱动使用的go.mongodb.org/mongo-driver/bson包都支持通过结构体字段标签（struct tags）来控制序列化和反序列化行为。对于MongoDB，我们使用bson标签。
要实现即使字段非空也阻止其写入MongoDB的目的，可以使用特殊的bson:"-"标签。这个标签告诉BSON编码器，在将Go结构体转换为BSON文档时，完全忽略带有此标签的字段。
立即学习“go语言免费学习笔记（深入）”；
示例：
type Person struct {
ID primitive.ObjectID `bson:"_id,omitempty"` // MongoDB 的 _id 字段
Name string `bson:"name"` // 字段名映射
SSN string `bson:"-"` // 使用 bson:"-" 标签，此字段将完全不被写入 MongoDB
HashedSSN string `bson:"hashedSSN"` // 字段名映射
}在上述Person结构体中，SSN字段被标记为bson:"-"。这意味着无论SSN字段中存储了什么值，它都不会被序列化并发送到MongoDB数据库。同时，SSN仍然是一个导出字段（首字母大写），可以在Go程序的任何地方正常访问和使用。
示例代码：使用 go.mongodb.org/mongo-driver
为了更清晰地演示，我们将使用Go官方的MongoDB驱动go.mongodb.org/mongo-driver来展示如何应用bson:"-"标签。
首先，确保你已经安装了MongoDB驱动：
go get go.mongodb.org/mongo-driver/mongo
以下是一个完整的Go程序，演示了如何定义一个包含bson:"-"标签的结构体，并将其插入到MongoDB中：
package main
import (
"context"
"crypto/sha1"
"encoding/base64"
"fmt"
"log"
"time"
"go.mongodb.org/mongo-driver/bson"
"go.mongodb.org/mongo-driver/bson/primitive" // 用于 MongoDB 的 ObjectID 类型
"go.mongodb.org/mongo-driver/mongo"
"go.mongodb.org/mongo-driver/mongo/options"
)
// Person 结构体定义，包含要忽略的字段
type Person struct {
ID primitive.ObjectID `bson:"_id,omitempty"` // MongoDB 的 _id 字段，omitempty 表示如果为空则不插入
Name string `bson:"name"` // 将 Go 字段名 Name 映射到 MongoDB 字段名 name
SSN string `bson:"-"` // 使用 bson:"-" 标签，此字段将完全不被写入 MongoDB
HashedSSN string `bson:"hashedSSN"` // 将 Go 字段名 HashedSSN 映射到 MongoDB 字段名 hashedSSN
}
func main() {
// 连接MongoDB
clientOptions := options.Client().ApplyURI("mongodb://localhost:27017")
ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
defer cancel() // 确保上下文在函数结束时被取消
client, err := mongo.Connect(ctx, clientOptions)
if err != nil {
log.Fatalf("无法连接到MongoDB: %v", err)
}
defer func() {
// 确保在程序退出前断开MongoDB连接
if err = client.Disconnect(ctx); err != nil {
log.Fatalf("断开MongoDB连接失败: %v", err)
}
}()
// 检查连接是否成功
err = client.Ping(ctx, nil)
if err != nil {
log.Fatalf("Ping MongoDB失败: %v", err)
}
fmt.Println("成功连接到MongoDB!")
// 获取数据库和集合
collection := client.Database("testdb").Collection("people")
// 清理之前的测试数据（可选，用于每次运行都从干净状态开始）
_, err = collection.DeleteMany(ctx, bson.M{})
if err != nil {
log.Printf("清理旧数据失败: %v", err)
}
// 创建一个 Person 实例
bob := Person{
Name: "Bob",
SSN: "fake_ssn_12345", // 这个字段包含数据，但因为 bson:"-" 标签，它不会被写入数据库
}
// 计算 HashedSSN 并赋值
hasher := sha1.New()
hasher.Write([]byte(bob.SSN))
sha := base64.URLEncoding.EncodeToString(hasher.Sum(nil))
bob.HashedSSN = sha
fmt.Printf("准备插入的Go结构体: %+v\n", bob)
// 插入文档到MongoDB
insertResult, err := collection.InsertOne(ctx, bob)
if err != nil {
log.Fatalf("插入文档失败: %v", err)
}
fmt.Printf("文档插入成功，MongoDB生成的_id: %v\n", insertResult.InsertedID)
// 验证：从数据库中查询并打印
var retrievedPerson Person
// 使用插入时生成的 _id 来查询
filter := bson.M{"_id": insertResult.InsertedID}
err = collection.FindOne(ctx, filter).Decode(&retrievedPerson)
if err != nil {
log.Fatalf("查询文档失败: %v", err)
}
// 打印检索到的 Go 结构体
// 注意：retrievedPerson.SSN 在 Go 程序中会是其零值（空字符串），因为数据库中没有这个字段。
fmt.Printf("从数据库检索到的Go结构体: %+v\n", retrievedPerson)
fmt.Printf("验证：retrievedPerson.SSN 是否为空字符串？ %t\n", retrievedPerson.SSN == "")
}
运行上述代码后，你会发现bob.SSN在插入前有值，但在从数据库中检索retrievedPerson时，retrievedPerson.SSN将是一个空字符串。这是因为SSN字段从未被写入数据库，因此在反序列化时无法从数据库中获取任何值来填充它，所以它会保持其Go类型的零值。
注意事项
- BSON标签的通用性： bson标签是Go语言与MongoDB交互的标准机制，它不仅适用于mgo库，也完全适用于官方推荐的go.mongodb.org/mongo-driver。因此，这种方法具有良好的通用性。
- 字段名称映射： 除了bson:"-"，bson标签还常用于将Go结构体字段名映射到不同的MongoDB文档字段名，例如bson:"name"会将Go的Name字段映射到MongoDB的name字段。
- omitempty标签的区别： bson:",omitempty"是另一个常用的标签，它表示当字段的值是其类型的零值时（例如，字符串为空，整数为0，切片为nil），该字段将不会被序列化。这与bson:"-"不同，bson:"-"是无条件忽略，即使字段有值也会被忽略。
- 反序列化行为： 如果一个字段被bson:"-"标签忽略，那么在从MongoDB数据库读取数据并反序列化到Go结构体时，该字段将不会被填充，而是会保持其Go类型的零值（例如，字符串为空字符串""，整数为0，布尔值为false，指针为nil）。
- 数据安全和隐私： 这种技术在处理敏感数据时非常有用。它允许应用程序在内存中处理完整数据（如计算哈希），但只将经过处理的安全数据（如哈希值）存储到持久化存储中，从而增强了数据安全性和隐私保护。
总结
通过在Go结构体字段上使用bson:"-"标签，我们可以精确控制哪些字段应该被持久化到MongoDB数据库中，哪些字段应该被忽略。这种方法提供了一种简洁、高效且强大的机制，使得Go开发者能够在保持代码清晰和字段可访问性的同时，灵活地管理数据存储策略，特别适用于处理敏感信息或仅在应用程序内部使用的临时数据。
