应使用 json.RawMessage 占位而非 interface{}，因其能保留原始 JSON 字节、避免类型断言失败和静默丢数据；声明时须导出、不加 omitempty、非指针；解析需在父结构体有效期内完成，并检查 len(raw)>0 且 json.Valid(raw)。
直接用 json.RawMessage 占位，别碰 interface{} —— 后者在动态字段场景下几乎必然导致类型断言失败或静默丢数据。
为什么不能把动态字段声明为 interface{} 或 map[string]interface{}
Go 的 json.Unmarshal 对 interface{} 有固定映射规则：JSON object → map[string]interface{}，array → []interface{}，string → string。一旦你期望它是个 CreateMessage 结构体，却硬要从 map[string]interface{} 强转过去，运行时 panic 是板上钉钉的。
更麻烦的是，这种转换无法保留原始 JSON 的格式细节（比如 float64 精度、null 值语义），也绕不开二次序列化开销。
- 字段值是
null时，interface{}解出来是nil，但你无法区分“字段没传”和“字段明确传了 null” - 嵌套结构里含非法 JSON（比如多了一个逗号），错误发生在第一层
Unmarshal，堆栈不指向业务逻辑，难定位 - 想验证某个子字段是否存在？得先做一堆
if v, ok := data["user"]; ok { ... }，代码膨胀且易错
json.RawMessage 字段声明必须注意的三个硬约束
json.RawMessage 是 []byte 别名，不是“智能容器”，它只存原始字节，不做任何解析。所以结构体定义稍有偏差，就直接失效。
立即学习“go语言免费学习笔记（深入）”；
- 字段名必须导出（首字母大写），否则
json包根本不会处理它 -
json:tag 里绝不能加omitempty—— 否则 JSON 中该字段为null或缺失时，Data字段会是nil，后续json.Unmarshal直接 panic - 不要写成
*json.RawMessage——json包不支持对指针类型的RawMessage解析，会报cannot unmarshal object into Go value of type *json.RawMessage
正确示例：
type Event struct {
ID string `json:"id"`
Type string `json:"type"`
Data json.RawMessage `json:"data"` // ✅ 无 omitempty，非指针，导出
}
解析 json.RawMessage 时最容易 panic 的两个时机
它不持有内存拷贝，只是对原始缓冲区的切片引用。一旦父结构体被 GC 或作用域结束，RawMessage 就可能指向已释放内存。
- 把
resp.Data直接返回给其他函数，然后在外部调用json.Unmarshal—— 如果resp已离开作用域，大概率panic: invalid memory address or nil pointer dereference - 反复对同一个
json.RawMessage调用json.Unmarshal—— 每次都分配新对象，旧对象靠 GC 回收，高频场景下 GC 压力陡增
安全做法是：在接收它的方法内部立刻解析，或封装成带缓存的方法：
func (e *Event) GetDataAsUser() (*User, error) {
if len(e.Data) == 0 {
return nil, errors.New("data is empty")
}
var u User
if err := json.Unmarshal(e.Data, &u); err != nil {
return nil, err
}
return &u, nil
}
测试中验证 json.RawMessage 字段的三类断言方式
测试不能只 mock 一种形态。真实响应中 data 可能是 object、array、string、number，甚至 null 或完全缺失。
- 确认字段存在且非空：
assert.True(t, len(resp.Data) > 0)—— 比!= nil更准，因为null的RawMessage是长度为 4 的切片（内容为"null"） - 验证是合法 JSON object：
var m map[string]interface{}; err := json.Unmarshal(resp.Data, &m)，捕获json.SyntaxError或json.InvalidUnmarshalError - 验证子字段存在且类型正确：先
json.Unmarshal(resp.Data, &map[string]json.RawMessage)，再取目标 key 的RawMessage单独解析并断言
区分 “字段没返回” 和 “字段返回了 null” 必须同时检查：len(raw) == 0 和 bytes.Equal(raw, []byte("null")) —— 这个细节 90% 的测试代码会漏掉。
