Go结构体数组字段插入MongoDB默认null而非空数组的原因及方案

Go 里切片类型的零值是 nil，你在控制台打印看到空数组效果，是 Go 标准库格式化输出的默认渲染规则——nil 切片会直接显示成 []，根本不是切片真的初始化好了。Mongo 官方驱动把结构体序列化成 BSON 写库的时候，nil 切片会被映射成 BSON 里的 null 类型，不会转成空数组，这就是数据库里 data 字段变成 null 的核心原因。
至于name、number字段能正常返回默认值，是因为string的零值就是空字符串""、int的零值就是0，序列化时会正常写入对应类型的零值，自然不会出现null。

除了你已经试过的插入前手动赋值、请求端传空数组这两种方法，还有三个更省心的方案，不用每次插入前单独记着处理这个字段：

• 给模型写统一的构造函数，所有要生成Test结构体的地方都走这个构造方法，从根源上避免切片是nil的问题：

type Test struct{
    Name string `json:"name"   bson:"name"`
    Number int  `json:"number" bson:"number"`
    Data []int  `json:"data"   bson:"data"`
}

// 所有实例化Test的逻辑都调用这个方法
func NewTest() Test {
    return Test{
        Name: "",
        Number: 0,
        Data: []int{},
    }
}

不管是接口绑定完请求参数后补初始化，还是业务逻辑里新建模型对象，都用NewTest()生成，就能保证Data字段永远是初始化过的空切片，序列化写库后就是[]，不会变成null。

• 写个通用的切片初始化工具函数，插入数据库前统一处理：用反射遍历结构体的所有字段，碰到切片类型、且值为nil的字段，自动替换成对应类型的空切片。如果项目里模型多、数组字段多，用这个方法不用给每个模型单独写构造逻辑，复用性更高。
• 自定义BSON序列化逻辑：给Test结构体实现MarshalBSON方法，序列化前先判断Data字段如果是nil，就替换成[]int{}再走正常序列化流程。这个方案对上层业务完全没侵入，不用改现有实例化结构体的代码。

避坑提醒：别给Data字段加bson:",omitempty"标签，加了之后如果Data是空数组，序列化时会直接跳过这个字段不写入MongoDB，最后查询返回的结果里会直接缺data字段，反而出别的问题。

内容的提问来源于stack exchange，提问作者Darien Miller