ULID不是UUID v7，不能直接替代UUID v7场景（如PostgreSQL UUID类型校验或OpenAPI format: uuid），但作为Go微服务中时间有序、全局唯一、短字符串ID是实用折中方案，前提是下游系统不强制RFC 9562合规。
ULID 不是 UUID v7，不能直接替代 UUID v7 场景（比如 PostgreSQL 的 UUID 类型校验或 OpenAPI 的 format: uuid），但它在 Go 微服务中作为「时间有序 + 全局唯一 + 短字符串」ID 是非常实用的折中方案——前提是你的下游系统不强制要求 RFC 9562 合规。
为什么用 oklog/ulid 而不是 github.com/google/uuid
github.com/google/uuid 完全不支持 ULID；它只处理标准 UUID 格式（v1–v5、v18）。而 oklog/ulid 是专为 ULID 设计的 Go 实现，生成的是 128-bit 二进制数据，编码为 26 字符 base32 字符串（如 01FRTZQ4KX2PZVQYQXJQYQXJQY），天然带毫秒级时间戳前缀，字典序可排序。
常见错误现象：
• 直接把 ULID 字符串塞进 PostgreSQL 的 UUID 字段 → 报错 invalid input syntax for type uuid
• 用 uuid.Parse() 解析 ULID 字符串 → 返回 invalid UUID format 错误
使用场景：
• API 请求 ID、日志 trace ID、缓存 key、文件名等无需数据库原生 UUID 类型支持的场景
• 需要按时间范围快速筛选（如查最近一小时所有请求）
• 想避免 Snowflake 的 nodeID 分配难题，又不想用 36 字符 UUID
立即学习“go语言免费学习笔记（深入）”；
初始化 ULID 生成器必须传入单调时钟
ULID 时间戳部分来自 time.Time，但 Kubernetes 或容器环境里 time.Now() 可能回跳（NTP 校时、闰秒），导致生成重复 ID 或 panic。不能依赖默认构造函数。
正确做法是显式传入一个单调递增的时间源：
- 用
ulid.MustNew(ulid.Timestamp(time.Now()), rand.Reader)是危险的 ——time.Now()不保证单调 - 应封装一层单调时钟适配器，例如：
func monotonicNow() ulid.Time { t := time.Now() // fallback to monotonic diff if wall clock regressed if t.UnixMilli() < lastULIDTime { t = time.UnixMilli(lastULIDTime + 1) } lastULIDTime = t.UnixMilli() return ulid.Time(t.UnixMilli()) } - 启动时初始化全局生成器：
var globalULID = ulid.MustNew(monotonicNow(), rand.Reader)
并发安全：别复用同一个 *rand.Rand 实例
oklog/ulid 的 MustNew 和 New 都接受 io.Reader 参数用于随机后缀。若多个 goroutine 共享单个 *rand.Rand（尤其未加锁），会触发竞态读写，导致 panic 或熵耗尽。
推荐方式：
• 使用 crypto/rand.Reader（线程安全，底层调用系统熵池）
• 或用 sync.Pool 缓存私有 *rand.Rand 实例，避免每次 new
示例（安全且高效）：
var randPool = sync.Pool{
New: func() interface{} {
b := make([]byte, 10)
return rand.New(&rand.XorShift64Star{Seed: uint64(time.Now().UnixNano())})
},
}
func genULID() ulid.ULID {
r := randPool.Get().(*rand.Rand)
defer randPool.Put(r)
return ulid.MustNew(ulid.Timestamp(time.Now()), r)
}
注意：crypto/rand.Reader 在容器环境熵池不足时可能阻塞，若对延迟极度敏感，需监控 /proc/sys/kernel/random/entropy_avail 并预热。
与数据库和序列化层的兼容性处理
ULID 是 26 字符字符串，不是标准 UUID，所以不能直接当 uuid.UUID 用。你在 ORM 或 SQL 扫描时必须做类型桥接。
常见坑：
• GORM 中字段声明为 uuid.UUID → 扫描 ULID 字符串时报错
• JSON 序列化时没注册自定义 marshaler → 输出成空对象或 panic
解决方案：
• 数据库层：把字段类型设为 string 或 text，插入前调用 ulid.MustNew(...).String()
• JSON 层：为 ULID 类型实现 MarshalJSON/UnmarshalJSON 方法，或统一用 string 字段接收
• 如果必须映射为 uuid.UUID（比如对接旧代码），可用 ulid.MustNew(...).Bytes() 转 16 字节再构造 uuid.FromBytes()，但注意这**不等于 UUID v7**，只是二进制兼容，语义已丢失
真正容易被忽略的一点：ULID 的时间精度是毫秒，同一毫秒内最多生成 2^80 个（理论值），实际靠随机后缀防撞，但如果你在单进程内每毫秒生成超 10 万 ID，碰撞概率虽低仍需监控 —— 此时该切回 Snowflake 或 UUID v7。
