API 与 URL 的紧凑 ID 编码流程
面向 API 与 URL 场景统一 ID 与编码策略,平衡可读性、长度、排序性与跨系统兼容。
标识符格式会直接影响日志检索、URL 可读性和跨系统兼容。这个流程帮助团队统一选型,减少后续返工。
本指南涉及工具
1)先按用途选 ID 类型
当时间有序很重要时用 UUID v7,适合事件流和数据库写入场景。
当追求短随机标识时用 NanoID,适合前端实体键值和短引用。
2)再按传输约束选编码
需要更强可读性并避免混淆字符时,优先 Base58。
需要通用二进制文本传输时,优先 Base64,并明确解码约定。
3)把格式约定固化到规范
每个字段固定一种标准格式,并在校验和文档中统一执行。
故障排查时建议同时记录原始 ID 和标准化编码值。