如何利用Golang反射构建REST响应模型_Golang reflect结构体解析与包装

技术教程
2025-12-23 09:56:58

Go反射构建REST响应模型的核心是让结构体自动适配统一API格式（如{"code":0,"msg":"ok","data":{...}}），通过反射提取字段、处理类型、支持过滤与别名，不破坏类型安全。

如何利用golang反射构建rest响应模型_golang reflect结构体解析与包装

用 Go 反射构建 REST 响应模型，核心不是“炫技”，而是让结构体自动适配统一的 API 返回格式（比如 {"code": 0, "msg": "ok", "data": {...}}），同时保留字段语义和控制权。关键在：只反射需要的部分，不破坏类型安全，不滥用 interface{}。

定义标准响应结构体

先明确接口契约，所有返回都走同一壳子：

type Resp struct {
    Code int         `json:"code"`
    Msg  string      `json:"msg"`
    Data interface{} `json:"data,omitempty"`
}

注意：Data 是 interface{}，但不直接塞原始结构体——要经过反射包装，才能支持字段过滤、别名、空值处理等。

用反射提取并转换目标结构体

写一个通用函数，接收任意结构体指针，返回清洗后的 map（或新结构体）：

用 reflect.ValueOf(v).Elem() 获取实际值（必须传指针）
遍历字段，检查 json tag：取 name 作为 key，忽略以小写字母开头的未导出字段
对每个字段值做类型判断：slice/map/struct 递归处理；time.Time 转字符串；nil 指针转为 JSON null（需额外标记）
可选加白名单/黑名单标签，如 api:"ignore" 或 api:"redact"

示例片段：

MimicPC

一个AI驱动的浏览器运行工具，可以通过浏览器在线安装及运行各种开源的AI应用程序

145 查看详情 MimicPC

func toMap(v interface{}) map[string]interface{} {
    rv := reflect.ValueOf(v).Elem()
    rt := reflect.TypeOf(v).Elem()
    m := make(map[string]interface{})
    for i := 0; i < rv.NumField(); i++ {
        field := rt.Field(i)
        if !rv.Field(i).CanInterface() { continue }
        jsonTag := field.Tag.Get("json")
        if jsonTag == "-" { continue }
        name := strings.Split(jsonTag, ",")[0]
        if name == "" { name = field.Name }
        m[name] = rv.Field(i).Interface()
    }
    return m
}