UUID 生成

UUID 生成

生成通用唯一标识符。适配工作流使用 - 随机 UUID 在重放时返回一致的值。

加载

local uuid = require("uuid")

随机 UUID

Version 1

基于时间的 UUID，包含时间戳和节点 ID。

local id, err = uuid.v1()

返回值: string, error

Version 4

随机 UUID。

local id, err = uuid.v4()

返回值: string, error

Version 7

时间排序的 UUID。可按创建时间排序。

local id, err = uuid.v7()

返回值: string, error

确定性 UUID

Version 3

使用 MD5 从命名空间和名称生成确定性 UUID。

local id, err = uuid.v3(namespace, name)

参数	类型	描述
namespace	string	有效的 UUID 字符串
name	string	要哈希的值

返回值: string, error

Version 5

使用 SHA-1 从命名空间和名称生成确定性 UUID。

local NS_URL = "6ba7b811-9dad-11d1-80b4-00c04fd430c8"
local id, err = uuid.v5(NS_URL, "https://example.com/resource")

参数	类型	描述
namespace	string	有效的 UUID 字符串
name	string	要哈希的值

返回值: string, error

检查

验证

local valid = uuid.validate(input)

参数	类型	描述
input	any	要检查的值

返回值: boolean, error

获取版本

local ver, err = uuid.version(id)

参数	类型	描述
uuid	string	有效的 UUID 字符串

返回值: integer, error

获取变体

local var, err = uuid.variant(id)

参数	类型	描述
uuid	string	有效的 UUID 字符串

返回值: string, error (RFC4122、Reserved、Microsoft、Future、NCS 或 Invalid)

解析

local info, err = uuid.parse(id)

参数	类型	描述
uuid	string	有效的 UUID 字符串

返回值: table, error

返回表字段：

• version (integer): UUID 版本（1、3、4、5 或 7）
• variant (string): RFC4122、Reserved、Microsoft、Future、NCS 或 Invalid
• timestamp (integer): Unix 时间戳（仅 v1 和 v7）
• node (string): 节点 ID（仅 v1）

格式化

local formatted, err = uuid.format(id, "standard")
local formatted, err = uuid.format(id, "simple")
local formatted, err = uuid.format(id, "urn")

参数	类型	描述
uuid	string	有效的 UUID 字符串
format	string?	standard（默认）、simple 或 urn

返回值: string, error

错误

条件	类型	可重试
无效的输入类型	errors.INVALID	否
无效的 UUID 格式	errors.INVALID	否
不支持的格式类型	errors.INVALID	否
生成失败	errors.INTERNAL	否

参见 错误处理 了解如何处理错误。