Python UUID 的 version 参数：只是想检查第四版，为什么传入的编号反而被改了
接口要求第四版UUID，开发者很自然地写下UUID(value, version=4)，以为不合格的编号会被拒绝。实际上，version是构造时的覆盖参数：它会把版本与变体相关位设置为指定布局。原文能够解析，并不意味着传入的每一位都被保留，校验代码可能悄悄制造了另一个编号。
本文在Linux、CPython 3.12.14实跑，讨论该版本已有的UUID构造器语义。保存为demo.py并运行python3 demo.py。输入全部是固定教学字符串，程序不调用uuid1、uuid4或硬件地址读取，不访问网络，不产生真实业务标识。字节位置在输出中按零开始编号。
AI生成的概念示意图：机械印章改变标识序列中的预留位置，说明指定版本会覆盖部分结构位；图形位置不对应真实字节偏移。
完整程序与本次实跑
完整可运行程序
from uuid import UUID, RFC_4122
text = "ffffffff-ffff-ffff-ffff-ffffffffffff"
parsed = UUID(text)
forced = UUID(text, version=4)
print("parsed:", str(parsed))
print("parsed version:", parsed.version)
print("forced:", str(forced))
print("forced version:", forced.version)
changed = [i for i, (a, b) in enumerate(zip(parsed.bytes, forced.bytes)) if a != b]
assert changed == [6, 8]
assert str(forced) == "ffffffff-ffff-4fff-bfff-ffffffffffff"
assert UUID(text, version=4) == forced
print("changed byte positions:", changed)
print("same input repeats:", UUID(text, version=4) == forced)
def require_v4(value):
result = UUID(value)
if result.variant != RFC_4122 or result.version != 4:
raise ValueError("not an RFC-layout version-4 UUID")
return result
try:
require_v4(text)
except ValueError:
print("unmodified input: rejected")
else:
raise AssertionError("input was silently accepted")
assert require_v4(str(forced)) == forced
print("modified value: accepted by structural check")本次实际输出（以下为结果，不是程序）
parsed: ffffffff-ffff-ffff-ffff-ffffffffffff parsed version: None forced: ffffffff-ffff-4fff-bfff-ffffffffffff forced version: 4 changed byte positions: [6, 8] same input repeats: True unmodified input: rejected modified value: accepted by structural check
同一字符串经两种构造得到不同编号
parsed仍是全部f的原编号，parsed version为None，因为其变体不属于本例检查的RFC布局。forced则在第三组开头出现4、第四组开头出现b，version变为4。两次调用使用相同字符串，差别来自显式传入的version参数，而不是随机生成或格式化大小写。
断言比较十六个原始字节，只发现索引六与八发生变化。这里改的是含有版本和变体标志的字节中的特定位，并非把全部字节重新生成。输出中的连字符只是UUID常见显示形式，真正的身份比较仍由内部的一百二十八位值决定。
构造参数不能代替输入规则检查
require_v4先调用不带version的UUID，随后读取variant和version。原文不符合规则时显式抛出ValueError，所以unmodified input被拒绝。这样保留了一个重要性质：被接受的对象来自原值，检查过程不会顺手把不合格输入修成另一个合法外观。
如果解析失败，UUID本身也会抛出异常，调用边界应当将这些失败统一转成明确的输入错误。不要捕获异常后再用version参数“再试一次”，否则客户端发送什么与服务器保存什么之间就多了一次未约定的变换，查重和审计都会变得困难。
结构合格并不证明生成过程合格
modified value通过结构检查，因为它的版本和变体位已经被设置好。但其余位依然几乎全是f，无法据此证明它来自随机生成器。require_v4验证的是允许的布局，而不是追溯一个字符串最初是由谁、以什么算法产生的。
same input repeats为True进一步说明，UUID(text, version=4)对这个固定输入得到固定结果，绝没有为每次调用补充随机性。需要创建随机第四版标识时应使用为该目的提供的生成接口；需要接收已有标识时则应解析并核对应用要求。二者是不同任务。
先确定是否允许文本写法归一化
构造器允许常见的不同文本写法，例如连字符和大小写差异，随后str输出统一形式。这种文本归一化可以不改变内部值；指定version则可能改变内部值。对接口而言，应明确允许哪些输入表示，而不只看输出是不是长得整齐。
如果业务要求严格的小写连字符格式，可以在完成结构校验后比较原字符串与str结果，再决定是否拒绝非规范写法。若业务接受多种等价表示，则存储时统一格式即可。不要把文本格式限制、结构版本限制与标识的来源可信度混成一个布尔判断。
把身份不变性写进验收样本
可以准备已符合第四版布局的编号、其它版本编号、不支持的变体和非十六进制文本，并检查通过的结果是否保持原始内部值。此次程序使用全f输入，是为了让覆盖位置明显可见，不是建议把这种编号用于真实数据。
不同Python版本可能增加新的UUID版本和生成接口，本文没有把3.12的版本范围推断到所有未来版本。迁移时应读对应文档，并保留“验证不得修改身份”的测试。对于主键、关联键或回调事件编号，这个约束通常比打印出来的版本数字更重要。
参考资料
官方资料核验于2026年10月2日；上述输出来自本次固定输入实跑，退出码为0。
