Go反射构建REST响应模型的核心是让结构体自动适配统一API格式（如{"code":0,"msg":"ok","data":{...}}），通过反射提取字段、处理类型、支持过滤与别名，不破坏类型安全。
用 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（或新结构体）：
立即学习“go语言免费学习笔记（深入）”；
- 用
reflect.ValueOf(v).Elem()获取实际值（必须传指针） - 遍历字段，检查
jsontag：取name作为 key，忽略以小写字母开头的未导出字段 - 对每个字段值做类型判断：slice/map/struct 递归处理；time.Time 转字符串；nil 指针转为 JSON null（需额外标记）
- 可选加白名单/黑名单标签，如
api:"ignore"或api:"redact"
示例片段：
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
}
封装成可链式调用的响应构造器
避免每次手动 new Resp + 赋值。设计一个 builder：
OK().Data(user).Msg("success").JSON(w)- 内部在
Data()阶段触发反射解析，缓存结果（避免重复反射） - 支持
WithCode(int)、WithError(error)等快捷方法，自动映射 error → msg/code - 最终
JSON()调用json.Marshal，不提前序列化，保持调试友好性
注意边界与性能取舍
反射不是银弹：
- 不要在高频路径（如每秒万级请求）中反复反射同一结构体类型——可结合
sync.Map缓存reflect.Type对应的字段信息 - 敏感字段（密码、token）必须显式忽略，不能依赖反射自动过滤；
json:"-"仅影响 JSON 输出，不影响反射读取 - 嵌套结构体深度建议限制（如 ≤5 层），避免栈溢出或无限循环（如 struct A 包含 B，B 又包含 A）
- 单元测试务必覆盖零值、nil 指针、time.Time、自定义 marshaler 类型
基本上就这些。反射在这里只是“粘合剂”，真正重要的是约定好数据流向和控制点，而不是让它替你做决策。
