空结构体返回{}而非null，因go的json.marshal将空结构体（如struct{}或全零值结构体）视为有效值并序列化为{}；nil指针字段才输出null，需用*struct类型并设为nil才能实现。
为什么空结构体返回的是 {} 而不是 null
Go 的 json.Marshal 对空结构体（如 struct{} 或所有字段为空值的结构体）默认序列化为 {}，而不是 null。Gin 基于标准库 encoding/json，所以行为一致。这不是 Gin 的 bug，而是 Go JSON 序列化的底层约定。
如果你希望 API 返回 null（比如表示“无数据”），不能靠结构体本身“空”来触发，必须显式控制序列化逻辑。
用指针字段 + omitempty 实现可选空值
最常用且安全的做法：把结构体字段声明为指针类型，并配合 omitempty 标签。这样当字段为 nil 时，该字段会被忽略；若整个结构体字段都为 nil，外层对象可能变为空对象 —— 但你可以进一步控制。
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
type User struct { Name *string `json:"name,omitempty"` Age *int `json:"age,omitempty"` }- 创建实例时：只赋值需要的字段，其余保持
nil - Gin 返回时，未赋值字段不会出现在 JSON 中，避免冗余空字段
- 注意：
omitempty对指针、切片、map 等零值类型有效，但对非空结构体字段无效（哪怕它内部全零）
让整个结构体字段输出为 null：用 *T 类型并允许 nil
如果某个响应字段语义上是“可能不存在”，比如 Profile *UserProfile，那就直接用指针类型声明，不加 omitempty。这样当它为 nil 时，JSON 就是 "profile": null。
type Response struct { Data *UserProfile `json:"data"` }-
c.JSON(200, Response{Data: nil})→{"data": null} -
c.JSON(200, Response{Data: &UserProfile{}})→{"data": {}}（仍是空对象） - 关键点：只有
*T为nil才输出null；空结构体地址（&T{}）永远输出{}
完全屏蔽空结构体字段：自定义 MarshalJSON 方法
当你要彻底改变某个结构体的 JSON 行为（例如：所有字段都零值时，整体输出 null 而非 {}），就得实现 MarshalJSON() 方法。
- 不要在空结构体上直接实现（
struct{}无法附加方法），而是在包装它的类型上做 - 例如：
type NullableUser User，然后为NullableUser实现MarshalJSON - 在方法里手动检查所有字段是否为零值，是则返回
json.RawMessage("null")，否则调用json.Marshal - 性能有轻微损耗，且容易漏判嵌套结构或自定义类型零值，仅在强需求时使用
真正难的不是怎么写这个方法，而是判断“什么是空”——比如一个含 time.Time 字段的结构体，其零值是 0001-01-01，不是 nil，容易误判。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
