Go中protobuf Timestamp需用timestamppb包转换：声明用google.protobuf.Timestamp，赋值用timestamppb.Now()或timestamppb.New()，读取用AsTime()，校验用CheckValid()，不可直赋time.Time或访问字段。
Go 中直接用 google.protobuf.Timestamp 必须手动转换，不能当 time.Time 用 —— 这是绝大多数人踩坑的第一步。
proto 文件里怎么声明 Timestamp 字段
必须显式导入 google/protobuf/timestamp.proto，且字段类型写全路径：
syntax = "proto3";
import "google/protobuf/timestamp.proto";
message Event {
string id = 1;
google.protobuf.Timestamp created_at = 2;
}
注意：created_at 类型不是 Timestamp，也不是 timestamp.Timestamp，而是 google.protobuf.Timestamp。生成 Go 代码后，它对应的是 *timestamppb.Timestamp（来自 google.golang.org/protobuf/types/known/timestamppb）。
Go 代码中怎么赋值和读取 Timestamp 字段
不能直接传 time.Time，也不能对 *timestamppb.Timestamp 做结构体字段访问。所有操作都要走 timestamppb 提供的封装函数：
立即学习“go语言免费学习笔记（深入）”；
-
timestamppb.Now()生成当前时间的 protobuf Timestamp 指针 -
timestamppb.New(t time.Time)把任意time.Time转成 protobuf Timestamp -
ts.AsTime()把*timestamppb.Timestamp转回time.Time（安全，nil 友好） -
ts.CheckValid()验证是否为合法时间（秒/纳秒范围合规），避免反序列化脏数据
示例：
event := &pb.Event{
Id: "evt-123",
CreatedAt: timestamppb.Now(), // ✅ 正确
}
// 或
t := time.Date(2026, 4, 3, 15, 30, 0, 0, time.UTC)
event.CreatedAt = timestamppb.New(t)
// 读取
if event.CreatedAt != nil {
goTime := event.CreatedAt.AsTime() // ✅ 安全转 time.Time
fmt.Println(goTime.Format(time.RFC3339))
}
为什么不能直接嵌入或类型别名 Timestamp
Protobuf 的 Timestamp 是一个带 seconds 和 nanos 字段的 message，不是 Go 原生类型。常见错误包括：
- 试图
type MyTS = timestamppb.Timestamp然后当成 struct 用字段赋值 —— 编译失败，字段不可导出 - 在 JSON API 中直接暴露
*timestamppb.Timestamp—— 默认序列化为{"seconds": ..., "nanos": ...}，前端不友好 - 忽略
CheckValid()就调用AsTime()—— 若 proto 数据非法（如seconds = -1），AsTime()会 panic
若需 JSON 输出为 Unix 时间戳，应在 HTTP handler 层做转换，而不是改 protobuf 类型本身。
与自定义 Timestamp 类型混用的风险
你项目里可能已有类似 type Timestamp time.Time 的本地类型。它和 timestamppb.Timestamp 完全无关：
- 二者不兼容，无法直接赋值或类型断言
- JSON 序列化行为完全不同：前者按需定制（比如只输出秒），后者固定输出对象格式
- 数据库存取时，MongoDB 的
bson.Marshal不认识timestamppb.Timestamp，必须先.AsTime()
真正容易被忽略的点：只要用了 protobuf，就该把时间字段的“源头”统一收口到 timestamppb；中间层转换（如转 time.Time 或转 JSON 秒数）应该明确发生在边界处，而不是到处散落 .AsTime()。
