python 3 用 uuid.uuid4() 生成随机 uuid 对象,str() 得到带连字符的 36 字符文本,hex 属性得到 32 个十六进制字符。读取已有编号时用 uuid.uuid(text) 还原对象,并捕获格式错误。随机 uuid 的碰撞概率很低,但不是绝不重复,也不能替代业务权限校验。

生成随机 UUID,并检查两种文本形式
以下代码可单独保存执行。每次生成的具体值会变化,测试应检查格式和版本,而不是断言等于某个写死的随机值。UUID 对象可以直接比较是否相等,持久化时则要统一使用带连字符或无连字符形式。
import uuid
identifier = uuid.uuid4()
text = str(identifier)
compact = identifier.hex
assert identifier.version == 4
assert len(text) == 36
assert len(compact) == 32
assert text.replace("-", "") == compact
assert uuid.UUID(text) == identifier
print("标准形式:", text)
print("无连字符:", compact)
uuid4 适合作为随机标识符,但编号本身不是访问授权。对外暴露资源编号后,接口仍需核验用户是否能访问该资源;若业务要求唯一键,应让数据库唯一约束承担最终检查。
把标准字符串和十六进制字符串还原为同一个对象
UUID 构造函数支持标准带连字符文本和无连字符十六进制文本。下列示例用固定的已知编号说明转换,输出可以复现;大小写输入会被规范化为小写的标准形式。解析错误应由调用方明确处理。
import uuid
standard = "550e8400-e29b-41d4-a716-446655440000"
compact = "550E8400E29B41D4A716446655440000"
a = uuid.UUID(standard)
b = uuid.UUID(compact)
assert a == b
assert str(b) == standard
assert b.hex == "550e8400e29b41d4a716446655440000"
try:
uuid.UUID("not-a-uuid")
except ValueError:
print("格式错误已识别")
else:
raise AssertionError("无效文本不应解析成功")
解析成功只说明能够解释为 UUID,不代表它来自可信系统、尚未使用过,或一定是业务指定的版本。不要通过字符串形式是否带连字符来判断它的安全性或生成方式。

需要 UUID v4 时单独验证 version
若接口只接受 v4 编号,应先解析再检查 version。不要给构造函数传 version=4 来“验证”输入,因为该参数会改写相应版本位;下面的函数保留输入原有信息,并拒绝其他版本。
import uuid
def parse_v4(text):
identifier = uuid.UUID(text)
if identifier.version != 4:
raise ValueError("需要 UUID v4")
return identifier
valid = "550e8400-e29b-41d4-a716-446655440000"
assert str(parse_v4(valid)) == valid
for text in ["not-a-uuid", "00000000-0000-0000-0000-000000000000"]:
try:
parse_v4(text)
except ValueError:
print("拒绝无效格式或不符合版本要求的编号")
else:
raise AssertionError("该输入应被拒绝")
本例只处理字符串输入,真实接口还应先验证字段类型。UUID 的数值大小不能用作 uuid4 的生成时间顺序;需要时间排序时应另存可信时间字段或选择明确支持该需求的设计。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











