不能直接用 time.Now().UnixNano() 做分布式ID，因其在并发、容器化、时钟回拨等场景下易重复且无序；推荐用 sonyflake 等自研 Snowflake 变种生成 64 位有序整型 ID。
为什么不能直接用 time.Now().UnixNano() 做分布式ID
因为并发下纳秒级时间戳会重复，尤其在单机高QPS或容器化部署（多个实例共享同一时钟源）时更明显。Linux系统调用 clock_gettime(CLOCK_MONOTONIC) 虽单调但不跨进程唯一；而 time.Now() 本质是系统时钟快照，无法保证多实例间顺序和唯一性。
- 单机压测 5k QPS 就可能触发 ID 冲突（实测常见于
sync/atomic未对齐或竞态未防护的自增逻辑） - 容器重启后时钟可能回拨，导致生成 ID 乱序甚至倒流，破坏数据库主键递增假设
- 纯时间戳 ID 缺乏业务语义，下游排查时无法区分来源服务或分片信息
推荐用 github.com/google/uuid 还是自研 Snowflake 变种
github.com/google/uuid 默认生成的是 RFC 4122 v4 UUID（随机数），虽然全局唯一，但长度 36 字符、不可排序、存储和索引开销大，不适合做 MySQL 主键或 Redis 键名。业务系统更倾向 64 位整型 ID：紧凑、有序、支持范围查询。
- 标准 Snowflake（Twitter）结构是 64bit = 41bit 时间戳 + 10bit 机器ID + 12bit 序列号，Go 中常用
github.com/bwmarrin/snowflake - 但它的
Node初始化依赖固定machine id，K8s 环境 Pod 频繁启停会导致node id分配冲突或需外部协调（如 etcd） - 更稳妥的做法是用
github.com/sony/sonyflake：支持自定义StartTime、用os.Hostname()+ 启动时间哈希生成machine id，且序列号自动重置防溢出
如何让 Snowflake ID 包含业务上下文（比如租户/模块标识）
标准 Snowflake 没法塞入业务字段，硬改位宽会压缩时间可用年限或降低并发能力。正确做法是「逻辑组合」而非「物理嵌入」：
- 保持 ID 本体仍是 64 位 Snowflake 整数（用于 DB 主键、缓存 key），额外在业务表加
tenant_id或module_code字段，联合索引加速查询 - 若必须单字段表达，可将 Snowflake ID 与业务标识做异或（
id ^ (uint64(tenantID) ），但要注意这会破坏单调性，仅适用于非排序场景 - 更安全的方案是用
github.com/segmentio/fastuuid生成前缀（如"t_123_"）拼接 Snowflake 字符串 ID，但这就放弃整型优势了
在 Gin/GORM 中集成 ID 生成器的关键陷阱
Gin 中间件或 GORM BeforeCreate 钩子里调用 ID 生成器时，容易忽略并发安全和初始化时机：
立即学习“go语言免费学习笔记（深入）”；
-
sonyflake.NewSonyflake()必须全局复用一个实例，不能每次请求都 new —— 它内部用sync.Mutex保护序列号，频繁创建会丢失状态 - GORM 的
BeforeCreate钩子接收的是指针，需显式赋值：u.ID = sf.NextID()，而不是u.ID = sf.NextID() + 0（后者可能触发 copy 导致 ID 未写入原结构） - K8s 下多个 Pod 同时启动，
sonyflake默认用time.Now()做初始时间，若系统时钟未同步（NTP 未就绪），可能触发ErrStartTimeIsNotValid
最简健壮初始化写法：
var sf *sonyflake.Sonyflake
func initIDGenerator() {
sf = sonyflake.NewSonyflake(sonyflake.Settings{
StartTime: time.Date(2023, 1, 1, 0, 0, 0, 0, time.UTC),
MachineID: func() (uint16, error) {
h, _ := os.Hostname()
return uint16((hash.Fnv32String(h) >> 16) & 0x3ff), nil
},
})
if sf == nil {
log.Fatal("failed to initialize sonyflake")
}
}
真正难的不是生成 ID，而是让所有服务实例在无中心协调的前提下，各自生成不重叠、可排序、带足够熵的 ID —— 这要求你对时钟行为、部署拓扑和语言 runtime 并发模型都有基本敬畏。
