在使用Go语言的`mgo`库与MongoDB交互时，有时需要定义结构体字段，但又不希望这些字段被持久化到数据库中。本文将详细介绍如何利用Go结构体标签（`bson:"-"`）来精确控制`mgo`库的序列化行为，实现即使字段非空也能被完全忽略，从而避免将敏感或临时数据写入数据库，同时保持Go语言的命名规范和代码可读性。
理解mgo与Go结构体的默认行为
在Go语言中，当使用mgo库将一个结构体实例插入到MongoDB集合时，mgo会默认将结构体中所有可导出的（即首字母大写的）字段映射为MongoDB文档的字段。例如，如果有一个Person结构体包含Name和SSN字段，mgo会尝试将这两个字段及其对应的值都写入数据库。
然而，在实际应用中，我们经常遇到这样的场景：
- 敏感数据处理： 某些字段（如社会安全号SSN、密码等）在应用逻辑中需要存在，但出于安全考虑，不应直接存储在数据库中，通常会存储其哈希值或加密后的形式。
- 临时或计算字段： 结构体中可能包含一些只在内存中用于临时计算或逻辑处理的字段，它们不属于数据库模型的一部分。
- 避免小写字段： Go语言的惯例是使用首字母大写的字段表示可导出，首字母小写的字段表示不可导出。将字段改为小写虽然可以阻止mgo持久化它，但这会使其在包外部无法访问，限制了其在应用中的使用，并且违背了Go的编码规范。
考虑以下Person结构体示例，其中SSN字段包含敏感信息，我们希望在应用中处理它（例如计算哈希），但不要将其直接存储到MongoDB中：
立即学习“go语言免费学习笔记（深入）”；
package main
import (
"crypto/sha1"
"encoding/base64"
"fmt"
"log" // 使用log代替fmt.Println处理错误
"gopkg.in/mgo.v2" // 推荐使用gopkg.in/mgo.v2
)
type Person struct {
Name string
SSN string // 此字段包含敏感信息，不应直接存入DB
HashedSSN string
}
func main() {
bob := Person{"Bob", "fake_ssn_123", ""}
// 计算SSN的哈希值
hasher := sha1.New()
hasher.Write([]byte(bob.SSN))
sha := base64.URLEncoding.EncodeToString(hasher.Sum(nil))
bob.HashedSSN = sha
// 连接MongoDB
mgoSession, err := mgo.Dial("mongodb://localhost:27017") // 使用完整URI
if err != nil {
log.Fatalf("mongo_config#initMongoSessions : Could not dial to mgoSession: %v", err)
}
defer mgoSession.Close() // 确保会话关闭
// 获取数据库和集合
c := mgoSession.DB("test").C("person")
// 插入数据
err = c.Insert(bob)
if err != nil {
log.Fatalf("Failed to insert person: %v", err)
}
fmt.Println("Person inserted successfully (without field tag). Check your DB to see SSN is stored.")
}运行上述代码，SSN字段及其值"fake_ssn_123"将会被存储到MongoDB中，这并非我们所期望的。
解决方案：使用bson:"-"结构体标签
Go语言的结构体标签提供了一种强大的机制，允许开发者为结构体字段附加元数据。mgo库利用这些标签来控制字段的序列化和反序列化行为。要实现字段的完全忽略，即使其值非空，可以使用bson:"-"标签。
bson:"-"标签的含义是告诉mgo（以及其他遵循BSON标签规范的库，如mongo-driver）在将Go结构体实例转换为BSON文档时，完全忽略带有此标签的字段。这意味着该字段既不会被写入数据库，也不会在从数据库读取数据时被填充（除非你手动处理）。
示例：使用bson:"-"标签忽略SSN字段
我们将修改Person结构体，为SSN字段添加bson:"-"标签：
package main
import (
"crypto/sha1"
"encoding/base64"
"fmt"
"log"
"gopkg.in/mgo.v2"
)
type Person struct {
Name string
SSN string `bson:"-"` // 添加此标签，mgo将忽略此字段
HashedSSN string
}
func main() {
bob := Person{"Bob", "fake_ssn_123", ""}
// 计算SSN的哈希值
hasher := sha1.New()
hasher.Write([]byte(bob.SSN))
sha := base64.URLEncoding.EncodeToString(hasher.Sum(nil))
bob.HashedSSN = sha
// 连接MongoDB
mgoSession, err := mgo.Dial("mongodb://localhost:27017")
if err != nil {
log.Fatalf("mongo_config#initMongoSessions : Could not dial to mgoSession: %v", err)
}
defer mgoSession.Close()
// 获取数据库和集合
c := mgoSession.DB("test").C("person")
// 插入数据
err = c.Insert(bob)
if err != nil {
log.Fatalf("Failed to insert person: %v", err)
}
fmt.Println("Person inserted successfully (with bson:\"-\" tag). Check your DB to confirm SSN is NOT stored.")
// 验证：从数据库读取并打印
var retrievedPerson Person
err = c.Find(nil).One(&retrievedPerson) // 查找并读取第一个文档
if err != nil {
log.Fatalf("Failed to retrieve person: %v", err)
}
fmt.Printf("Retrieved Person: %+v\n", retrievedPerson)
// 注意：retrievedPerson.SSN 将会是空字符串，因为在反序列化时也被忽略了
}代码解释：
- SSN stringbson:"-"`：这行代码是关键。bson:"-"标签告诉mgo在将Person结构体实例序列化为BSON文档时，完全跳过SSN`字段。
- 在main函数中，bob.SSN仍然可以被正常赋值和使用（例如用于计算HashedSSN）。
- 当执行c.Insert(bob)时，mgo会生成一个不包含SSN字段的BSON文档并将其插入到MongoDB中。
- 在从数据库读取数据时，mgo也会忽略bson:"-"标记的字段，因此retrievedPerson.SSN会是其零值（空字符串），即使数据库中可能存在其他文档的SSN字段（如果之前没有使用此标签插入过）。
注意事项与最佳实践
- 双向忽略： bson:"-"标签不仅阻止字段写入数据库，也阻止字段从数据库读取。这意味着如果你从数据库中检索一个文档，并且该文档包含一个与Go结构体中标记为bson:"-"的字段同名的字段，那么该字段的值将不会被映射到Go结构体中，它会保持其零值。
-
与其他bson标签结合： bson标签非常灵活。除了"-"之外，你还可以使用：
- bson:"fieldName"：将Go字段映射到不同的MongoDB字段名。
- bson:",omitempty"：如果字段是其零值（例如，字符串为空，整型为0，布尔型为false，切片或映射为nil），则在写入数据库时忽略该字段。这与bson:"-"不同，omitempty在字段有值时仍然会写入。
- bson:",inline"：将内嵌结构体的字段提升到父文档的顶层。
- 安全性考量： 即使使用了bson:"-"来避免存储敏感数据，也务必确保敏感数据在应用程序内部的处理是安全的。例如，对SSN进行哈希处理是一个好的实践，但完整的安全方案还应包括传输加密、访问控制等。
- 替代方案（不推荐用于此场景）： 将字段首字母改为小写，使其成为不可导出字段。虽然这也能阻止mgo持久化它，但会限制其在包外部的访问，通常不符合Go的API设计哲学。bson:"-"标签是更优雅、更符合惯例的解决方案。
总结
通过在Go结构体字段上使用bson:"-"标签，开发者可以精确控制mgo库的序列化行为，确保特定的字段即使包含数据也不会被持久化到MongoDB中。这种方法不仅解决了敏感数据不应存储在数据库的问题，还保持了Go语言的命名规范和结构体字段的可访问性，是处理这类场景的推荐方案。理解并合理运用Go结构体标签，能够显著提升Go应用程序与MongoDB交互的灵活性和安全性。
