Django Admin无法为含自引用外键的模型创建记录

这个错误的核心原因是Django在处理自关联外键referee时，没有正确将选择的Customer对象转换为对应的主键ID，导致传递了对象实例而非数字类型的ID值。以下是几种实用的解决方法：

方法1：使用raw_id_fields优化自关联字段显示 #

在admin.py中为Customer注册Admin类，并指定raw_id_fields，让Admin通过ID输入框选择关联对象，避免下拉选择时的类型转换问题：

from django.contrib import admin
from .models import Customer

class CustomerAdmin(admin.ModelAdmin):
    list_display = ('name', 'created_at', 'updated_at', 'referee')
    # 用ID输入框替代下拉选择，解决类型转换错误
    raw_id_fields = ('referee',)

admin.site.register(Customer, CustomerAdmin)

这种方式不仅能解决当前错误，还能在Customer数据量较大时提升Admin页面的加载性能。

方法2：显式配置ModelForm的queryset #

如果需要保留下拉选择的样式，可以自定义ModelForm并显式指定referee字段的queryset，确保表单正确处理关联对象：

from django import forms
from django.contrib import admin
from .models import Customer

class CustomerForm(forms.ModelForm):
    class Meta:
        model = Customer
        fields = '__all__'

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 显式关联Customer的查询集
        self.fields['referee'].queryset = Customer.objects.all()

class CustomerAdmin(admin.ModelAdmin):
    form = CustomerForm
    list_display = ('name', 'created_at', 'updated_at', 'referee')

admin.site.register(Customer, CustomerAdmin)

方法3：检查自定义逻辑 #

如果项目中存在pre_save信号或其他自定义保存逻辑，需要确认这些代码是否错误地将referee字段设置为Customer对象实例而非ID值。Django通常会自动处理对象到ID的转换，但自定义代码可能破坏这一逻辑，需排查修正。

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