如何在 Go 中实现 JSON 反序列化后自动填充计算字段-Golang-PHP中文网

本文介绍在 Go 中通过自定义 UnmarshalJSON 方法，实现在 json.Unmarshal 完成后自动计算并填充派生字段（如 FullName），避免手动调用计算函数，提升代码健壮性与可维护性。

本文介绍在 go 中通过自定义 `unmarshaljson` 方法，实现在 `json.unmarshal` 完成后自动计算并填充派生字段（如 `fullname`），避免手动调用计算函数，提升代码健壮性与可维护性。

在 Go 的 JSON 处理实践中，常遇到一类需求：结构体中存在由其他字段派生的“计算字段”（如 FullName = FirstName + " " + LastName），它们不应由 JSON 数据直接提供，而应在反序列化完成后自动构建。若依赖外部手动调用（如 entry.Compute()），不仅易遗漏、破坏封装性，还可能因调用时机不当导致数据不一致。

更优雅的方案是让类型自身承担这一职责——实现 json.Unmarshaler 接口。但需注意：不能直接在原结构体上实现 UnmarshalJSON，否则会引发无限递归（json.Unmarshal 内部会再次调用该方法）。正确做法是使用类型别名创建一个中间包装类型，将其作为 JSON 反序列化的目标，并在反序列化完成后注入计算逻辑。

以下是推荐实现：

type DataEntry struct {
    FirstName string `json:"first"`
    LastName  string `json:"last"`
    FullName  string // 计算字段，不参与 JSON 解析
}

// DataEntryForJSON 是用于 JSON 反序列化的包装类型
type DataEntryForJSON DataEntry

// UnmarshalJSON 实现 json.Unmarshaler 接口
func (d *DataEntryForJSON) UnmarshalJSON(b []byte) error {
    // 将原始字节反序列化到基础结构体（类型转换规避递归）
    if err := json.Unmarshal(b, (*DataEntry)(d)); err != nil {
        return err
    }
    // 自动填充计算字段
    d.FullName = d.FirstName + " " + d.LastName
    return nil
}

使用时，只需将 *DataEntryForJSON 传入 json.Unmarshal 或 json.NewDecoder：

使用Go语言搭建家庭相册系统-相关课件

下载

var entry DataEntryForJSON
if err := json.Unmarshal(data, &entry); err != nil {
    log.Fatal(err)
}
// 此时 entry.FullName 已自动计算完成
fmt.Println(entry.FullName) // e.g., "John Doe"

⚠️ 注意事项：