Go 的 time.Time 是值类型，其零值会序列化为 MongoDB 中的 ISODate("0001-01-01T00:00:00Z")（即毫秒时间戳 -62135596800000），无法直接映射为 null；需改用 *time.Time 指针类型或自定义 BSON 编解码逻辑实现真正的 null 语义。
go 的 `time.time` 是值类型，其零值会序列化为 mongodb 中的 `isodate("0001-01-01t00:00:00z")`（即毫秒时间戳 `-62135596800000`），无法直接映射为 `null`；需改用 `*time.time` 指针类型或自定义 bson 编解码逻辑实现真正的 `null` 语义。
在使用 MongoDB 官方 Go 驱动（mongo-go-driver）时，一个常见且易被忽视的陷阱是：如何让 Go 结构体中的时间字段在写入 MongoDB 时真正表现为 null，而非意外变成 ISODate("0001-01-01T00:00:00Z")。这是因为 time.Time 是一个结构体（struct），不具备 nil 状态——它的零值（zero value）是 time.Time{}，经 BSON 序列化后固定对应 MongoDB 的最小有效时间戳 Date(-62135596800000)，这并非 null，而是一个合法但极早期的时间值。
✅ 推荐方案：使用 *time.Time 指针类型
最简洁、安全且符合 Go 惯例的方式，是将日期字段声明为指针：
type Order struct {
ID primitive.ObjectID `bson:"_id,omitempty"`
ProductName string `bson:"product_name"`
ShippedAt *time.Time `bson:"shipped_at"` // ← 关键：指针类型
}- 当
ShippedAt == nil时，驱动自动将其序列化为 MongoDB 的null； - 当
ShippedAt != nil（例如&time.Now()）时，正常存为 ISODate； - 读取时若数据库该字段为
null，反序列化后ShippedAt自动为nil，可安全判空：
if order.ShippedAt != nil {
fmt.Println("Shipped on:", order.ShippedAt.Format(time.RFC3339))
} else {
fmt.Println("Not shipped yet")
}✅ 优势：无需额外逻辑、零运行时开销、完全兼容驱动原生行为、清晰表达“可选时间”的业务语义。
⚠️ 替代方案：保留 time.Time + 自定义编解码（仅限兼容性受限场景）
若因历史原因无法修改结构体字段类型（如 ORM 兼容、第三方 SDK 约束），可通过实现 bson.Marshaler / bson.Unmarshaler 接口手动控制：
type Event struct {
ID primitive.ObjectID `bson:"_id,omitempty"`
Title string `bson:"title"`
Occurred time.Time `bson:"-"` // 不直连 BSON
POccurred *time.Time `bson:"occurred"` // 实际映射字段
}
// GetBSON 实现写入逻辑
func (e *Event) GetBSON() (interface{}, error) {
// 若 occurred 为零值，则设为 nil → MongoDB null
if e.Occurred.IsZero() {
e.POccurred = nil
} else {
e.POccurred = &e.Occurred
}
// 返回自身（已更新 POccurred）
return e, nil
}
// SetBSON 实现读取逻辑
func (e *Event) SetBSON(raw bson.Raw) error {
type Alias Event // 防止递归调用
aux := &struct {
POccurred *time.Time `bson:"occurred"`
*Alias
}{
Alias: (*Alias)(e),
}
if err := raw.Unmarshal(aux); err != nil {
return err
}
if aux.POccurred == nil {
e.Occurred = time.Time{} // 或按需设为特定默认值
} else {
e.Occurred = *aux.POccurred
}
return nil
}⚠️ 注意事项：
-
GetBSON/SetBSON仅在使用bson.M或直接调用collection.InsertOne(ctx, doc)等原生方法时生效；若使用collection.FindOne().Decode(&v)，需确保结构体字段标签与接口实现协同； - 此方式增加维护成本，且易引入时序/并发 bug（如
GetBSON修改字段状态），仅建议作为临时迁移手段。
? 关键实践提醒
-
永远避免
time.Time{}用于表示“未设置”：它在业务逻辑中易与真实时间混淆（如误判为“公元元年发货”）； -
连接字符串中密码含特殊字符时务必 URL 编码：使用
url.QueryEscape(password)，否则可能导致认证失败或解析异常； -
所有数据库操作必须携带带超时的
context.Context：防止 goroutine 泄漏，例如ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)； -
mongo.Client应全局复用：驱动内置连接池，重复创建Connect()将导致资源耗尽； - *
Find()返回的 `mongo.Cursor必须显式Close()**：推荐defer cursor.Close(ctx)`，否则游标长期占用服务端资源。
通过合理选用 *time.Time，你不仅能精准表达数据语义（“无时间” ≠ “时间起点”），还能显著提升代码可读性与系统健壮性——这是 Go + MongoDB 工程实践中一项关键的类型设计决策。
