如何在Go语言中生成并在MongoDB存储Type 4 UUID（BinData 0x04）

问题核心在于Go的uuid.UUID本质是[16]byte，默认BSON序列化会把字节数组识别为通用二进制数据（BinData 0），而MongoDB的标准UUID类型对应BinData 4，必须显式指定子类型才能让数据库正确识别。下面提供两种可行的解决办法：

方法一：使用MongoDB官方驱动的bson.UUID类型 #

这是最直接的方案，利用驱动提供的类型适配MongoDB的UUID存储规则：

1. 修改Document结构体，将ID字段类型替换为bson.UUID：

import "go.mongodb.org/mongo-driver/bson"

type Document struct {
    ID         bson.UUID `bson:"_id" json:"id"`
    FcrID      string    `bson:"fcrId" json:"fcrId"`
    ContextKey string    `bson:"contextKey" json:"contextKey"`
    PrivateKey string    `bson:"privateKey" json:"privateKey"`
    PublicKey  string    `bson:"publicKey" json:"publicKey"`
}

2. 生成UUID时直接转换为bson.UUID类型：

id := bson.UUID(uuid.New()) // uuid.New()返回[16]byte，直接强转即可

这样序列化后，MongoDB会自动将ID存储为BinData(4, "...")类型，完全符合Type4 UUID的存储要求。

方法二：自定义uuid.UUID的BSON编解码规则 #

如果不想修改结构体字段类型，可以给uuid.UUID实现BSON编解码接口，强制指定子类型：

import (
    "fmt"
    "github.com/google/uuid"
    "go.mongodb.org/mongo-driver/bson"
)

// 实现bson.Marshaler接口，序列化时指定UUID子类型
func (u uuid.UUID) MarshalBSON() ([]byte, error) {
    binData := bson.Binary{
        Subtype: bson.BinarySubtypeUUID, // 明确指定子类型为4
        Data:    u[:],
    }
    return bson.Marshal(binData)
}

// 实现bson.Unmarshaler接口，支持从数据库读取UUID
func (u *uuid.UUID) UnmarshalBSON(data []byte) error {
    var binData bson.Binary
    if err := bson.Unmarshal(data, &binData); err != nil {
        return err
    }
    if binData.Subtype != bson.BinarySubtypeUUID {
        return fmt.Errorf("无效的UUID子类型: %d", binData.Subtype)
    }
    copy(u[:], binData.Data)
    return nil
}

添加这两个方法后，原有的uuid.UUID类型在序列化时会被自动处理为BinData 4，无需修改结构体和UUID生成逻辑。

原代码失效原因 #

uuid.New()返回的uuid.UUID是[16]byte类型，Go的BSON驱动对普通字节数组的默认处理是使用通用二进制子类型（0），而MongoDB的UUID类型需要专门的子类型4来标识，因此必须显式指定才能让数据库识别为Type4 UUID。

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