如何修改Go生成模型的JSON标签名以适配外部Payload？

方案一：为Book结构体实现自定义UnmarshalJSON方法 #

利用Go标准库encoding/json的特性，当类型实现了UnmarshalJSON方法时，反序列化会优先调用该方法。这种方式无需修改自动生成的结构体定义，只需在同一包下添加该方法即可：

import (
    "encoding/json"
    "strconv"
)

// 为Book实现自定义反序列化方法
func (b *Book) UnmarshalJSON(data []byte) error {
    // 定义临时结构体接收JSON原始字段，仅包含需要特殊处理的字段和其他常规字段
    var temp struct {
        ID           int    `json:"id"`
        Title        string `json:"title"`
        Description  string `json:"description"`
        CategoryName string `json:"categoryName"`
    }

    // 先将JSON反序列化为临时结构体
    if err := json.Unmarshal(data, &temp); err != nil {
        return err
    }

    // 将临时结构体的值映射到原Book结构体
    b.ID = strconv.Itoa(temp.ID) // 处理数字ID转字符串
    b.Title = temp.Title
    b.Description = temp.Description
    b.Category = temp.CategoryName // 映射categoryName到Category

    return nil
}

使用时直接调用json.Unmarshal(jsonData, &book)即可，完全复用原结构体，无需复制。

方案二：利用反射自动映射（适合字段较多的场景） #

如果Book结构体字段非常多，手动写临时结构体麻烦，可以用反射遍历结构体字段，自动匹配JSON键，仅对特殊字段做单独处理：

import (
    "encoding/json"
    "reflect"
    "strconv"
)

func UnmarshalBook(data []byte) (*Book, error) {
    var raw map[string]interface{}
    if err := json.Unmarshal(data, &raw); err != nil {
        return nil, err
    }

    book := &Book{}
    bookVal := reflect.ValueOf(book).Elem()

    // 遍历Book结构体的所有字段
    for i := 0; i < bookVal.NumField(); i++ {
        field := bookVal.Type().Field(i)
        fieldVal := bookVal.Field(i)

        // 获取JSON标签名
        jsonTag := field.Tag.Get("json")
        if jsonTag == "" {
            jsonTag = field.Name // 无标签则用字段名（如需蛇形转驼峰可额外处理）
        }

        // 处理特殊映射：Category对应categoryName
        if field.Name == "Category" {
            if val, ok := raw["categoryName"].(string); ok {
                fieldVal.SetString(val)
                continue
            }
        }

        // 常规字段映射
        if val, ok := raw[jsonTag]; ok {
            switch fieldVal.Kind() {
            case reflect.String:
                // 处理ID字段的数字转字符串
                if field.Name == "ID" {
                    if num, ok := val.(float64); ok {
                        fieldVal.SetString(strconv.Itoa(int(num)))
                    }
                } else if strVal, ok := val.(string); ok {
                    fieldVal.SetString(strVal)
                }
            // 可根据需要添加其他类型的处理逻辑
            }
        }
    }

    return book, nil
}

这种方式无需关心结构体字段数量，仅需维护特殊字段的映射规则，适合大型结构体。

补充说明 #

如果项目允许使用第三方JSON库（如json-iterator/go），还可以通过给字段标签添加别名的方式快速实现映射，比如将Book结构体的Category字段标签改为json:"category,alias=categoryName"，但该方案依赖第三方库，需根据项目情况选择。

内容的提问来源于stack exchange，提问作者mrTarragona