Go使用MongoDB查询时struct的interface字段被转为键值对数组问题

问题原因 #

你遇到的问题是mongo-go-driver默认BSON解码规则导致的：当结构体字段声明为interface{}类型时，解码器会默认将BSON文档解析为bson.D类型，该类型本质是有序键值对切片[]bson.E，每个元素包含Key和Value两个属性，因此序列化为JSON时就会呈现为你看到的键值对数组格式，而非预期的嵌套对象格式。

解决方案 #

你可以根据业务场景选择以下任意一种方案解决：

方案1：全局配置默认解析BSON文档为Map #

在初始化MongoDB客户端时，开启DefaultDocumentM配置，该配置会指定所有interface{}类型接收的BSON文档默认解析为bson.M（即map[string]interface{}类型），序列化后就是正常的嵌套对象格式：

clientOpts := options.Client().ApplyURI("你的MongoDB连接地址").SetBSONOptions(&options.BSONOptions{
    DefaultDocumentM: true,
})
client, err := mongo.Connect(ctx, clientOpts)

方案2：手动转换bson.D为Map #

如果你不想修改全局配置，可以在解码后手动判断字段类型并转换：

for cursor.Next(context.Background()) {
    records := model.DData{}
    err = cursor.Decode(&records)
    if err != nil {
        // 处理错误逻辑
    }
    // 手动转换bson.D为map
    if d, ok := records.Data.(bson.D); ok {
        records.Data = d.Map()
    }
}

方案3：明确声明Data字段的结构体类型 #

如果Data字段的结构是固定的，建议直接定义对应的结构体类型代替interface{}，既避免类型转换问题，也能保证类型安全：

type DataContent struct {
    Field1 string `json:"field1" bson:"field1"`
    Field2 string `json:"field2" bson:"field2"`
    Field3 string `json:"field3" bson:"field3"`
}

type DData struct {
    Name      string       `json:"name" bson:"name"` 
    Data      DataContent  `json:"data" bson:"data"` // 替换为明确的结构体类型
    UpdatedAt time.Time    `json:"updated_at" bson:"updated_at"`
    SyncedAt  time.Time    `json:"synced_at" bson:"synced_at"`
}

内容的提问来源于stack exchange，提问作者Vallabh Lakade