AG UUID

UUID 使用最佳实践

以清单形式整理在实际工作中处理 UUID 时值得遵循的原则。

版本选择

如果没有特殊原因,通用场景请使用 v4;像数据库主键这样排序很重要的场景请使用 v7。只有在需要基于名称、可复现的 ID 时才考虑 v3、v5。

一致的格式

在同一个系统内,请将大小写和连字符格式统一为一种。小写并带连字符是最常见的标准,能够减少存储、比较和日志中的混乱。

安全隔离

UUID 只是唯一标识符,并不是机密。对于会话、密码重置令牌等需要难以被猜测的值,请使用专用的安全令牌而非 UUID,并始终使用密码学随机源来生成。

校验

对于从外部接收的 UUID,请在使用前校验其格式和版本。用检查器确认版本和变体,可以快速过滤掉错误的输入或与预期不符的版本。