如何在Django queryset的annotate中将UUID转换为整数？

两种写法的错误逻辑完全不同：

• 第一种int('pk')是在Python构造QuerySet的阶段，直接对字符串常量'pk'调用int转换，完全没有关联到数据库的pk字段，因此触发字面量转整数失败。
• 第二种Cast写法报错是数据库层面的硬性限制：标准UUID是128位长度，Django默认的IntegerField对应数据库32位整数、BigIntegerField对应64位整数，长度都不足以承载UUID的全量值，PostgreSQL本身禁止这类不兼容的强转操作。

根据实际业务场景选择对应方案即可：

方案1：Python层直接转换（优先推荐） #

如果不需要在数据库查询阶段就生成整数值，只是拿到查询结果后使用，直接利用Python原生UUID对象的内置属性转换即可，代码最简洁、无兼容性问题：

# 拿到UUID主键的查询结果
uuid_pks = list(Item.objects.values_list('pk', flat=True))
# 逐个转换为对应整数
int_pks = [pk.int for pk in uuid_pks]

提示：Python原生uuid.UUID实例自带的.int属性会直接返回128位UUID对应的完整整数值，不需要额外做字符串处理。

方案2：数据库annotate阶段转换 #

如果必须在查询阶段就生成整数字段（比如后续需要在数据库层面做排序、过滤、聚合），可以通过PostgreSQL的类型转换逻辑自定义Django数据库函数实现，注意不要用长度不足的整数类型：

from django.db.models import F, Func
from django.db.models.fields import DecimalField, BigIntegerField

# 自定义UUID转整数的数据库函数
class UUIDToInt(Func):
    # 如果只需要UUID的低64位整数值，用下面的配置，输出用BigIntegerField
    # template = "(%(expressions)s::uuid)::bigint"
    # output_field = BigIntegerField()
    
    # 如果需要128位UUID对应的完整整数值，用下面的配置，输出用DecimalField（numeric类型对应Django的DecimalField）
    template = "REPLACE(%(expressions)s::text, '-', '')::numeric"
    output_field = DecimalField(max_digits=40, decimal_places=0)

# 查询示例
queryset = Item.objects.annotate(
    int_of_pk=UUIDToInt(F('pk'))
)
# 可以直接取值使用
result = list(queryset.values_list('pk', 'int_of_pk'))

方案3：业务层新增整数字段（长期最优） #

如果业务场景长期需要用整数类型的唯一标识做关联、排序，不要硬转UUID，直接给Item模型新增一个自增的BigIntegerField或者AutoField作为专用整数字段，性能、兼容性远好于动态转换的方案。

内容的提问来源于stack exchange，提问作者SpencerF2