Go 的 json 包中，omitempty 标签会将零值（如 0、""、nil）视为“空”而忽略字段；若需保留 int 类型的 0 值，应使用指针类型（如 *int），使 nil 表示缺失、非 nil 表示显式赋值（含 0）。
go 的 `json` 包中，`omitempty` 标签会将零值（如 0、""、nil）视为“空”而忽略字段；若需保留 `int` 类型的 0 值，应使用指针类型（如 `*int`），使 `nil` 表示缺失、非 nil 表示显式赋值（含 0）。
在 Go 中处理 JSON 编解码时，omitempty 是一个常用但易被误解的标签。它的行为逻辑是：当字段值为其类型的零值时（例如 int 为 0，string 为 ""，bool 为 false，指针/切片/map 为 nil），该字段在序列化时被完全省略。这正是你遇到问题的根本原因——Integer: 0 被判定为“空”，因此 json.Marshal 后字段消失。
✅ 正确解决方案：使用指针类型
将结构体字段定义为指针，即可区分「字段未提供」（nil）和「字段显式设为零值」（如 *int 指向 0）：
type Test struct {
String *string `json:"string,omitempty"`
Integer *int `json:"integer,omitempty"`
}
// 解析原始 JSON
q := []byte(`{"string":"this is a string", "integer": 0}`)
var qq Test
if err := json.Unmarshal(q, &qq); err != nil {
panic(err)
}
// 此时 qq.Integer 是 *int，且指向值 0（非 nil）
queryStr, err := json.Marshal(qq)
if err != nil {
panic(err)
}
fmt.Println(string(queryStr))
// 输出：{"string":"this is a string","integer":0}
✅ 优势：
- nil 表示 JSON 中该字段不存在（真正“省略”）；
- 非 nil 指针（即使指向 0）表示客户端明确设置了该值，应原样保留；
- 完全兼容你的业务场景：解析 → 修改 → 转发，无需硬编码默认值。
⚠️ 注意事项与最佳实践
-
初始化指针字段需谨慎：手动赋值时应分配内存，例如：
i := 0 qq.Integer = &i
或使用工具函数简化：
func IntPtr(i int) *int { return &i } qq.Integer = IntPtr(0) 反序列化时 omitempty 对指针依然有效：若 JSON 中不包含 "integer" 字段，则 qq.Integer 保持 nil，符合预期；仅当字段存在（无论值为 0 或 42）才会被解出并分配内存。
避免过度使用指针：仅对需要区分“未设置”与“设为零”的字段才用指针。例如 ID、状态码、计数器等常需保留 0 的字段适用；而纯只读配置或无歧义语义的字段可维持值类型。
-
替代方案？不推荐：
- 自定义 MarshalJSON()/UnmarshalJSON() 方法虽可行，但增加复杂度且易出错；
- 移除 omitempty 会导致所有零值字段强制输出（如 0、""），可能违反下游 API 规范；
- 双结构体（input/output）方案冗余，违背 DRY 原则，且维护成本高。
✅ 总结
使用 *int（及其他基础类型的指针）是 Go 生态中处理「需保留零值的可选字段」的标准、简洁且健壮的方式。它精准匹配 JSON 的语义：null 或缺失 ≈ nil，显式数值（含 0）≈ 非 nil 指针。在构建 API 客户端、网关代理或配置处理器时，这一模式值得作为默认实践推广。
