当结构体实现 marshaljson() 方法时，若使用指针接收器但实际编码的是值类型（如 map[string]struct），该方法将不会被 json 包调用——根本原因是 go 的方法集规则：值类型不包含指针接收器方法。解决方式包括改为值接收器，或确保被编码的对象是对应指针类型。
当结构体实现 marshaljson() 方法时，若使用指针接收器但实际编码的是值类型（如 map[string]struct），该方法将不会被 json 包调用——根本原因是 go 的方法集规则：值类型不包含指针接收器方法。解决方式包括改为值接收器，或确保被编码的对象是对应指针类型。
在 Go 中，json.Marshal 和 json.Encoder.Encode 会自动查找并调用实现了 json.Marshaler 接口的类型方法：
type Marshaler interface {
MarshalJSON() ([]byte, error)
}
但能否成功调用，取决于方法接收器类型与实际值类型的匹配关系。
? 问题根源：方法集不匹配
你定义了：
func (u *Edition) MarshalJSON() ([]byte, error) { ... }
这是一个指针接收器方法，它只属于 *Edition 类型的方法集，而不属于 Edition 值类型的方法集。
而你的数据结构是：
var EditionsMap map[string]datamodel.Edition // ← 值类型，非指针
当 json 包遍历 EditionsMap 的 value（即 datamodel.Edition 实例）时，发现 Edition 类型本身没有 MarshalJSON 方法（因为方法集里只有 *Edition 有），于是退而使用默认结构体反射规则，跳过你的自定义逻辑——因此 "here" 永远不会打印。
✅ 解决方案一：改用值接收器（推荐）
只需将接收器从 *Edition 改为 Edition：
func (u Edition) MarshalJSON() ([]byte, error) {
vaultValue := u.Vault != nil
onlineValue := u.Online != nil
// 使用类型别名避免无限递归
type Alias Edition
return json.Marshal(&struct {
Vault bool `json:"vault,omitempty"`
Online bool `json:"online,omitempty"`
*Alias
}{
Vault: vaultValue,
Online: onlineValue,
Alias: (*Alias)(&u),
})
}
✅ 优势：
- 无论 Edition 是值还是指针（Edition 或 *Edition）都能触发该方法；
- 无需修改数据结构或调用方代码；
- 符合多数场景的灵活性需求。
⚠️ 注意：(*Alias)(&u) 是关键——它将 &u 转为别名类型的指针，避免在嵌入 *Alias 时再次触发 MarshalJSON，防止无限递归。
✅ 解决方案二：统一使用指针类型
若坚持使用指针接收器，需确保 map 存储的是指针：
var EditionsMap map[string]*datamodel.Edition // ← 改为 *Edition
// 初始化示例：
EditionsMap = make(map[string]*datamodel.Edition)
EditionsMap["v1"] = &datamodel.Edition{Vault: new(string), Online: nil}
然后编码保持不变：
if err := json.NewEncoder(w).Encode(EditionsMap); err != nil {
log.Printf("JSON encode error: %v", err) // 切勿忽略错误！
}
✅ 优势：适合需要区分零值/nil 的复杂场景；
❌ 劣势：强制调用方管理指针，增加内存分配与空指针风险。
? 其他常见陷阱提醒
- 不要忽略 json.Marshal 错误：你原代码中未检查 Encode 返回的 error，可能导致静默失败；
- 避免在 MarshalJSON 中直接调用 json.Marshal(u)：这会触发自身方法，造成栈溢出；
- omitempty 与布尔字段：bool 类型本身不支持 omitempty（除非为 false），但你的逻辑已通过显式赋值控制输出，合理；
- 字段名大小写敏感：确保结构体字段首字母大写（导出），否则 json 包无法访问。
✅ 最终验证建议
在单元测试中快速验证：
t.Run("marshal edition with nil fields", func(t *testing.T) {
e := datamodel.Edition{Vault: nil, Online: new(bool)}
data, _ := json.Marshal(e)
// 断言输出是否含 "vault":false, "online":true
})
遵循方法集规则，明确接收器语义，是 Go 序列化定制的基石。选择值接收器通常更健壮、更易维护。
