Golang：合并不同结构体并序列化，保持空Map而非Null

核心原因 #

Go里的map类型默认值是nil，encoding/json包序列化时，nil map会被转成null，而初始化后的空map（make(map[string]interface{})）才会被序列化为{}。你直接序列化Person数组时能得到空对象，说明原数组里的Person实例的Data字段是显式初始化过的空map；但放到[]interface{}处理后出现null，大概率是某个环节中Data被置为了nil，或者新追加的实例没初始化Data。

解决方法 #

1. 显式初始化所有Person实例的Data字段

在创建Person（包括追加的新实例）时，确保Data被初始化为空map，而不是留作默认的nil：

// 创建原Person实例
p1 := Person{
    Name: "Alice",
    Age:  30,
    Data: make(map[string]interface{}), // 显式初始化空map
}

// 要追加的新结构体
p2 := Person{
    Name: "Bob",
    Age:  25,
    Data: make(map[string]interface{}), // 同样初始化
}

// 用[]interface{}组装数组
var arr []interface{}
arr = append(arr, p1, p2)

// 序列化
jsonBytes, err := json.Marshal(arr)
if err != nil {
    // 处理错误逻辑
}
// 此时所有Data字段都会序列化为{}

2. 给Person结构体添加构造函数（推荐）

为了避免每次创建实例都手动初始化，可以写一个构造函数，确保Data始终是初始化好的空map：

func NewPerson(name string, age int) Person {
    return Person{
        Name: name,
        Age:  age,
        Data: make(map[string]interface{}),
    }
}

// 使用构造函数创建实例
p1 := NewPerson("Alice", 30)
p2 := NewPerson("Bob", 25)

arr := []interface{}{p1, p2}
// 序列化结果中所有Data字段均为{}

3. 自定义MarshalJSON强制处理nil map

如果无法保证所有实例都被初始化，可以给Person实现json.Marshaler接口，强制把nil的Data序列化为空对象：

func (p Person) MarshalJSON() ([]byte, error) {
    // 定义临时结构体复用原标签
    type TempPerson struct {
        Name string                 `json:"person_name"`
        Age  int                    `json:"person_age"`
        Data map[string]interface{} `json:"data"`
    }

    temp := TempPerson{
        Name: p.Name,
        Age:  p.Age,
        Data: p.Data,
    }

    // 替换nil map为空map
    if temp.Data == nil {
        temp.Data = make(map[string]interface{})
    }

    return json.Marshal(temp)
}

// 此时即使Person的Data是nil，序列化后也会是{}
p := Person{Name: "Charlie", Age: 35} // Data默认是nil
arr := []interface{}{p}
jsonBytes, _ := json.Marshal(arr)
// 输出结果: [{"person_name":"Charlie","person_age":35,"data":{}}]

内容的提问来源于stack exchange，提问作者Arpan Nayak