自定义主键导致Django Admin内联逻辑异常

问题场景 #

models.py中定义的自关联模型：

from uuid import uuid4
from django.db import models

class Example(models.Model):
    uid = models.UUIDField(primary_key=True, default=uuid4)
    title = models.CharField(max_length=128)
    parent = models.ForeignKey("self", related_name="subexamples", blank=True, null=True)

对应的Admin配置：

from .models import Example
from django.contrib import admin

class ExampleInline(admin.TabularInline):
    model = Example
    exclude = ("uid",)
    extra = 1
    verbose_name = "Subexample"
    show_change_link = True

class ExampleAdmin(admin.ModelAdmin):
    search_fields = ("title", )
    exclude = ("uid",)
    inlines = [ExampleInline,]

admin.site.register(Example, ExampleAdmin)

使用Django 5.0.2时，Admin中添加第一个内联对象后，无法执行删除或修改操作，仅提示“请纠正下方错误”但无具体错误信息，日志也未记录异常。

原因分析 #

Django Admin的内联组件依赖主键值追踪实例状态（新增/修改/删除），自定义UUID作为主键时，未保存的实例没有明确主键值，导致Admin无法正确识别内联对象状态，触发无明确提示的验证错误。

解决办法 #

方法1：给UUID主键添加editable=False #

修改models.py中的uid字段，标记为不可编辑，让Django Admin自动处理主键状态：

uid = models.UUIDField(primary_key=True, default=uuid4, editable=False)

可移除Admin配置中exclude = ("uid",)的设置，因为editable=False会自动让字段不在表单中显示，Admin能正确追踪主键状态。

方法2：显式指定内联的外键字段 #

在ExampleInline中添加fk_name，明确指定关联的外键字段，避免自关联时的识别混淆：

class ExampleInline(admin.TabularInline):
    model = Example
    fk_name = "parent"  # 显式指定自关联外键
    exclude = ("uid",)
    extra = 1
    verbose_name = "Subexample"
    show_change_link = True

方法3：改用默认整数主键，保留UUID为唯一字段 #

如果业务允许，保留Django默认的AutoField主键，将UUID设为唯一非主键字段：

class Example(models.Model):
    uid = models.UUIDField(unique=True, default=uuid4, editable=False)
    title = models.CharField(max_length=128)
    parent = models.ForeignKey("self", related_name="subexamples", blank=True, null=True)

此方法完全兼容Admin内联的默认逻辑，同时UUID可作为业务唯一标识使用。

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