在我们日常开发的 Go 项目中，用户信息管理是一个非常常见的场景。特别是当我们需要存储和处理用户密码等敏感信息时，如何确保这些信息不暴露给客户端就显得尤为重要。
今天我们来讨论一个简单而实用的技巧——如何在返回用户数据时，隐藏密码字段。
场景介绍
假设我们有一个 User 结构体，用于表示用户信息，结构体包含以下三个字段：
type User struct {
UserID int64 // 用户ID
Name string // 用户名
Password string // 用户密码（需要加密）
}
在这个例子中，Password 字段保存的是用户密码的加密结果。我们希望在返回用户数据时，不要把这个 Password 字段暴露给客户端。
那么，我们有什么办法呢？
这里我提供了以下 3 种思路，供各位参考。如果你有更好的方式，也欢迎留言讨论。
方法一：使用 JSON 标签忽略字段
Go 提供了一个非常便捷的方法来控制结构体字段的 JSON 序列化行为，那就是通过结构体标签（Tags）。我们可以在 Password 字段上添加 json:"-" 标签，表示在序列化成 JSON 时忽略这个字段：
type User struct {
UserID int64 `json:"user_id"`
Name string `json:"name"`
Password string `json:"-"` // 忽略该字段
}
当我们将 User 结构体序列化为 JSON 时，Password 字段将不会出现在结果中：
user := User{
UserID: 1,
Name: "John",
Password: "encrypted_password",
}
jsonData, err := json.Marshal(user)
if err != nil {
log.Fatal(err)
}
fmt.Println(string(jsonData))
// 输出: {"user_id":1,"name":"John"}
这样做的好处是简单直接，而且不需要更改其他代码，只需在定义结构体时添加一个标签即可。
方法二：自定义序列化逻辑
如果项目需求较为复杂，或者您希望在序列化时根据不同的条件动态控制输出内容，那么可以考虑自定义序列化逻辑。具体做法是实现 json.Marshaler 接口：
type User struct {
UserID int64
Name string
Password string
}
func (u User) MarshalJSON() ([]byte, error) {
return json.Marshal(struct {
UserID int64 `json:"user_id"`
Name string `json:"name"`
}{
UserID: u.UserID,
Name: u.Name,
})
}
在这个例子中，我们手动控制了 JSON 的输出内容，只包含 UserID 和 Name 字段，而 Password 字段则被自动忽略。
方法三：使用数据传输对象（DTO）
另一种常见且推荐的做法是使用数据传输对象（DTO, Data Transfer Object）。
这种方法的核心思想是将内部数据和外部数据表示分离，通过专门的结构体来控制输出内容。
首先，我们定义一个不包含 Password 字段的结构体 UserDTO：
type UserDTO struct {
UserID int64 `json:"user_id"`
Name string `json:"name"`
}
然后，在需要返回用户数据时，我们将 User 结构体转换为 UserDTO：
func NewUserDTO(user User) UserDTO {
return UserDTO{
UserID: user.UserID,
Name: user.Name,
}
}
最后，在实际使用时，我们只返回 UserDTO 的 JSON 数据：
user := User{
UserID: 1,
Name: "John",
Password: "encrypted_password",
}
userDTO := NewUserDTO(user)
jsonData, err := json.Marshal(userDTO)
if err != nil {
log.Fatal(err)
}
fmt.Println(string(jsonData))
// 输出: {"user_id":1,"name":"John"}
这种方法不仅可以隐藏敏感信息，还能增强代码的可读性和维护性。通过这种分层设计，我们可以轻松地控制数据的输入输出，避免不必要的安全风险。
总结
在项目开发过程中，保护敏感信息不被泄露是一项至关重要的工作。通过使用 JSON 标签、自定义序列化逻辑，或者数据传输对象（DTO），我们都可以有效地控制数据的输出内容，从而避免将敏感信息暴露给客户端。
根据您的实际需求，可以选择合适的方式来实现这一功能。如果只是简单地隐藏字段，使用 json:"-" 标签是最便捷的；如果需要更灵活的控制，推荐使用自定义序列化或 DTO 方式。
