如何在Go中通过JSON键名动态访问结构体字段？

这个问题我之前也碰到过，核心是你混淆了结构体字段名和JSON标签名的区别——reflect.FieldByName()是根据结构体定义里的字段名（比如MyNum）来查找的，而不是JSON标签里的req_num，这就是为什么你拿不到值的原因。

要实现根据JSON键名动态获取结构体字段值的需求，完全可行，我们可以通过反射遍历结构体字段，匹配每个字段的JSON标签来实现。

通用工具函数实现 #

先写一个可以复用的工具函数，专门处理“根据JSON标签名获取结构体字段值”的场景，同时兼容结构体值和指针类型：

import (
    "fmt"
    "reflect"
    "strings"
)

// GetFieldByJSONTag 根据JSON标签名获取结构体字段的值
// 支持传入结构体值或结构体指针，返回字段值和可能的错误
func GetFieldByJSONTag(obj interface{}, jsonTag string) (interface{}, error) {
    // 处理指针类型，自动解引用到结构体
    val := reflect.ValueOf(obj)
    for val.Kind() == reflect.Ptr {
        val = val.Elem()
    }

    // 校验输入是否为结构体类型
    if val.Kind() != reflect.Struct {
        return nil, fmt.Errorf("输入必须是结构体或结构体指针")
    }

    // 遍历结构体所有字段，匹配JSON标签
    typ := val.Type()
    for i := 0; i < typ.NumField(); i++ {
        field := typ.Field(i)
        // 获取字段的JSON标签
        tagContent := field.Tag.Get("json")
        if tagContent == "" {
            continue
        }
        // 处理带选项的标签（比如"req_num,omitempty"），只取逗号前的键名
        tagName := strings.Split(tagContent, ",")[0]
        if tagName == jsonTag {
            // 返回字段的实际值
            return val.Field(i).Interface(), nil
        }
    }
    return nil, fmt.Errorf("未找到JSON标签为%q的字段", jsonTag)
}

单参数使用示例 #

针对你的Params结构体，使用方式如下：

type Params struct { 
    MyNum string `json:"req_num"` 
}

func main() {
    params := Params{MyNum: "123"}
    // 或者传入指针：params := &Params{MyNum: "123"}

    // 根据JSON标签获取值
    val, err := GetFieldByJSONTag(params, "req_num")
    if err != nil {
        panic(err) // 实际项目中建议优雅处理错误
    }
    // 类型断言为对应的字段类型
    myNum, ok := val.(string)
    if !ok {
        panic("字段类型不匹配")
    }
    fmt.Println(myNum) // 输出：123
}

多参数批量处理 #

如果需要处理多个JSON键名，直接循环调用工具函数即可，完全不需要硬编码字段名：

func main() {
    params := Params{MyNum: "123"}
    // 需要处理的JSON键名列表
    targetTags := []string{"req_num", /* 可以添加其他标签名 */}
    
    // 存储结果的映射
    resultMap := make(map[string]interface{})
    for _, tag := range targetTags {
        val, err := GetFieldByJSONTag(params, tag)
        if err != nil {
            fmt.Printf("获取标签%s失败：%v\n", tag, err)
            continue
        }
        resultMap[tag] = val
    }

    // 输出结果
    fmt.Println(resultMap) // 输出：map[req_num:123]
}

注意事项 #

• 结构体字段必须是导出的（首字母大写），否则反射无法访问其值，你的MyNum已经满足这个要求。
• 函数会自动处理JSON标签的选项（比如omitempty），只匹配逗号前的核心键名。
• 如果需要设置值而不是获取值，只需要在找到对应字段后调用val.Field(i).Set(newValue)即可（注意值类型要匹配）。

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