Django模型中如何基于自身字段生成UUID5主键？

你当前的写法有两个核心问题：一是定义字段default参数时，模型实例还未创建，self根本不存在，无法直接引用字段值；二是uuid.uuid5的第一个参数要求是UUID对象，不能直接传入字符串。

下面是正确的实现方案，核心思路是重写模型的save方法，在实例创建阶段生成UUID5：

import uuid
from django.db import models
from django_countries.fields import CountryField

# 定义固定的命名空间UUID，你可以自己生成一个（比如用uuid.uuid4()生成后固定保存）
PLACE_UUID_NAMESPACE = uuid.UUID('1b671a64-40d5-491e-99b0-da01ff1f3341')

class Place(models.Model):
    uuid = models.UUIDField(primary_key=True, editable=False)
    city = models.CharField(max_length=24, blank=True, null=True)
    zip = models.CharField(max_length=6, blank=True, null=True)
    country = CountryField(default='US')

    def save(self, *args, **kwargs):
        # 仅在新建实例时生成UUID（主键为空说明是新增操作）
        if not self.uuid:
            # 拼接字段值，处理可能为空的字段避免报错
            seed_str = f"{self.city or ''}{self.zip or ''}{self.country.code}"
            self.uuid = uuid.uuid5(PLACE_UUID_NAMESPACE, seed_str)
        # 调用父类save方法完成最终保存
        super().save(*args, **kwargs)

关键细节说明： #

• 给uuid字段添加editable=False，防止在后台管理界面或表单中被误修改
• 仅在self.uuid为空时生成UUID，避免更新实例时覆盖原有主键
• 对可能为空的city和zip字段用or ''处理，防止拼接时出现None引发异常
• 固定命名空间UUID，确保相同的字段组合会生成一致的UUID5，符合UUID5的设计逻辑

批量创建的特殊处理 #

如果使用bulk_create批量创建实例，Django不会触发模型的save方法，需要手动提前生成UUID：

# 构造待创建的实例列表
place_list = [
    Place(city='New York', zip='10001', country='US'),
    Place(city='London', zip='SW1A', country='GB')
]

# 为每个实例生成UUID
for place in place_list:
    seed_str = f"{place.city or ''}{place.zip or ''}{place.country.code}"
    place.uuid = uuid.uuid5(PLACE_UUID_NAMESPACE, seed_str)

# 执行批量保存
Place.objects.bulk_create(place_list)

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