空结构体默认输出{}而非null，因go的json.marshal将非nil struct编码为空对象；解决需用marshaljson接口返回"null"或改用指针字段配合nil值。
为什么空结构体在 JSON 中默认输出为 {} 而不是 null
Gin 默认用 Go 标准库 json.Marshal 序列化响应，而 Go 的 struct（哪怕全字段为空）只要类型非 nil，就会被编码成空对象 {}。这和前端期望的“该字段不存在/应为 null”常有冲突，尤其在多层嵌套如 User.Profile.Address 中，某一级是空 struct，就卡在中间输出 {"profile": {"address": {}}}，而非更语义清晰的 {"profile": {"address": null}}。
用 json.Marshaler 接口手动控制空 struct 行为
给目标 struct 实现 MarshalJSON() 方法，是最直接、侵入性最小的方案。它不依赖 Gin 中间件或全局配置，只影响特定类型。
常见做法是：若 struct 所有字段都为零值，则返回 []byte("null")；否则调用 json.Marshal 原生序列化。
- 必须返回
nil错误才能让 Gin 正常处理；返回非 nil error 会导致 HTTP 500 - 注意指针接收者 —— 如果 struct 可能以指针形式传入（如
*Address），MarshalJSON必须定义在指针类型上，否则不会被调用 - 避免递归调用自身；需用
json.Marshal(&tmp)或反射跳过当前方法
func (a *Address) MarshalJSON() ([]byte, error) {
if a == nil {
return []byte("null"), nil
}
// 检查是否所有字段都为零值
if reflect.DeepEqual(*a, Address{}) {
return []byte("null"), nil
}
return json.Marshal(struct{ *Address }{a})
}
Gin 中间件统一处理嵌套 struct 的 omitempty 与 null 问题
中间件无法直接修改已序列化的 JSON 字节流，所以不能“事后替换 {} 为 null”。真正可行的是：在 c.JSON() 调用前，对响应数据做预处理，把空 struct 替换为 nil（Go 中 nil 指针在 JSON 序列化时即为 null）。
但要注意：nil 只对指针、map、slice、chan、func、interface{} 有效；普通 struct 值类型无法设为 nil，必须用指针包装。
- 推荐在业务逻辑中统一使用指针字段，例如
Profile *Profile而非Profile Profile - 中间件可配合
reflect遍历响应 map/interface{}，对每个 struct 字段判断是否全零，然后置为nil（仅适用于指针字段） - 性能敏感场景慎用深度反射；建议只对明确标注的结构体类型做处理，避免无差别扫描
避免踩坑：别依赖 omitempty 解决空 struct 显示问题
omitempty 标签只对零值字段生效，而空 struct（如 Address{}）本身不是零值 —— 它的零值就是它自己，所以 omitempty 对它无效。即使写成 Address Address `json:"address,omitempty"`，只要字段存在，就会输出 {}。
真正有效的组合是：
- 字段声明为指针：
Address *Address - 初始化时保持为
nil（而非&Address{}） - 需要时才 new 并赋值，否则序列化自然为
null
如果已有大量非指针 struct 字段，又不想改模型，那只能走 MarshalJSON 路线 —— 没有银弹，得按实际耦合程度选。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
