go-zero 框架本身不直接提供开箱即用的全局数据脱敏功能,但可以通过自定义 json.marshaler 接口或结合 encoding/json 的标签机制来实现。核心做法是在结构体字段上定义特定的脱敏规则(如保留前后缀、替换中间字符),并在序列化时拦截该字段的输出。这样在 api 响应返回前,敏感信息如手机号、身份证号会被自动处理,确保前端展示安全。

如何为单个字段实现通用的脱敏逻辑?
要实现通用的脱敏,可以定义一个包装类型并实现 MarshalJSON 方法。例如,创建一个 SensitiveString 类型,内部存储原始字符串。在序列化时,根据预设的规则(如手机号中间四位变星号)生成新字符串。这种方式比手动在每个 setter 里处理更优雅,且能复用。开发者只需将结构体中的 string 类型替换为 SensitiveString,即可在 JSON 输出时自动生效。

package main
import (
"encoding/json"
"fmt"
"strings"
)
// SensitiveString 是一个支持自动脱敏的字符串类型
type SensitiveString struct {
Value string
}
// MarshalJSON 实现 json.Marshaler 接口
func (s SensitiveString) MarshalJSON() ([]byte, error) {
if s.Value == "" {
return json.Marshal("")
}
// 简单的脱敏逻辑:保留前3位和后4位,中间用****代替
// 实际项目中可根据字段类型配置不同规则
masked := maskPhone(s.Value)
return json.Marshal(masked)
}
func maskPhone(phone string) string {
if len(phone) < 7 {
return phone
}
return phone[:3] + "****" + phone[len(phone)-4:]
}
// User 是示例业务结构体
type User struct {
ID int `json:"id"`
Name string `json:"name"`
Phone SensitiveString `json:"phone"`
Email string `json:"email"`
}
func main() {
user := User{
ID: 1,
Name: "张三",
Phone: SensitiveString{Value: "13812345678"},
Email: "zhangsan@example.com",
}
data, err := json.Marshal(user)
if err != nil {
fmt.Println("Error:", err)
return
}
fmt.Println(string(data))
}
运行上述代码,预期输出结果为:{"id":1,"name":"张三","phone":"138****5678","email":"zhangsan@example.com"}。可以看到 phone 字段被自动脱敏,而 email 保持原样。这种方案的优势在于业务逻辑与脱敏逻辑解耦,无需修改 Controller 层的代码。
如何在 Go-Zero 的 Service 层统一应用脱敏?
在 Go-Zero 的微服务架构中,通常建议在 Service 层组装好返回对象后,再统一进行序列化。如果项目中有大量敏感字段,可以为每个需要脱敏的结构体嵌入 SensitiveString 或使用组合模式。另一种更灵活的方式是使用反射或第三方库(如 github.com/mozillazg/go-sensitive 配合自定义 marshaler)来批量处理。但在标准库层面,最稳妥的做法依然是基于 MarshalJSON。开发者可以在 Service 的 GetUser 等方法中,直接返回包含 SensitiveString 类型的结构体实例,由 Go-Zero 内置的 JSON 编码器完成后续工作。

package service
import (
"context"
"your-project/internal/model"
)
type UserService struct {
// ... 依赖注入
}
func (u *UserService) GetUser(ctx context.Context, id int) (*model.UserResponse, error) {
// 1. 从数据库获取完整用户信息
user, err := u.GetUserFromDB(id)
if err != nil {
return nil, err
}
// 2. 转换为响应结构体,此时 Phone 字段已经是 SensitiveString 类型
resp := &model.UserResponse{
ID: user.ID,
Name: user.Name,
Phone: model.SensitiveString{Value: user.Phone}, // 关键步骤:赋值给脱敏类型
Email: user.Email,
}
return resp, nil
}
在上述 Service 代码中,model.UserResponse 的定义应包含 Phone model.SensitiveString。当 Go-Zero 的 RPC 或 HTTP 处理器调用 GetUser 并尝试将返回值序列化为 JSON 时,会自动触发 SensitiveString 的 MarshalJSON 方法。这确保了无论通过哪种入口访问,敏感数据都不会以明文形式流出。若需验证,可模拟一个 ID 为 1 的请求,观察返回的 JSON 中 phone 字段是否符合脱敏格式。
如何处理嵌套结构中的敏感字段?
当用户信息嵌套在其他结构中,例如 Order 中包含 User 信息时,脱敏逻辑依然有效。只要 User 结构体中的敏感字段类型是 SensitiveString,嵌套序列化时也会自动应用规则。开发者无需额外编写递归脱敏代码。例如,在 OrderResponse 中嵌入 *User 指针,序列化 OrderResponse 时,内部的 User 也会被正确脱敏。这证明了基于接口的脱敏方案具有良好的可扩展性和一致性,适用于复杂的业务数据结构。


















