Django admin StackedInline报错：'accounts.CustomUser'无对应字段问题

你的核心问题是搞反了Inline的关联方向，Django的Inline组件要求被嵌入的模型必须包含指向主模型的外键/一对一字段，而你当前的模型结构和Admin配置不匹配。

先明确模型结构（假设你的代码是这类情况） #

通常正确的一对一关联逻辑是：用户是基础身份，零售商是用户的扩展信息，也就是Retailer模型包含指向CustomUser的一对一字段：

# accounts/models.py
from django.contrib.auth.models import AbstractUser
from django.db import models

class CustomUser(AbstractUser):
    # 自定义用户字段，比如手机号
    phone = models.CharField(max_length=11, blank=True)

class Retailer(models.Model):
    # 一对一关联到CustomUser
    user = models.OneToOneField(CustomUser, on_delete=models.CASCADE, related_name='retailer')
    # 零售商额外信息
    store_name = models.CharField(max_length=100)
    address = models.TextField(blank=True)

为什么会报错？ #

你试图在Retailer的Admin页面嵌入CustomUser的Inline，但CustomUser模型里并没有指向Retailer的关联字段（不管是user还是retailer字段都在Retailer模型中），Django找不到两者的关联关系，所以抛出has no field named 'xxx'的错误。

正确解决方案（推荐，符合逻辑） #

把Retailer作为Inline嵌入到CustomUser的Admin页面里，这样超级管理员创建用户时就能直接填写零售商信息，一步完成账号和扩展信息的创建：

# accounts/admin.py
from django.contrib import admin
from django.contrib.auth.admin import UserAdmin
from .models import CustomUser, Retailer

# 定义零售商信息的Inline组件
class RetailerInline(admin.StackedInline):
    model = Retailer
    can_delete = False  # 不允许单独删除零售商信息（依赖用户存在）
    verbose_name_plural = '零售商信息'
    extra = 1  # 默认显示一个零售商信息表单

# 自定义用户Admin，嵌入零售商Inline
class CustomUserAdmin(UserAdmin):
    inlines = (RetailerInline,)
    # 可根据需求调整用户表单的字段分组
    fieldsets = UserAdmin.fieldsets + (
        ('自定义字段', {'fields': ('phone',)}),
    )

admin.site.register(CustomUser, CustomUserAdmin)
# 可选：注册Retailer的单独Admin，方便后续单独编辑零售商信息
admin.site.register(Retailer)

如果非要在Retailer Admin里创建用户（不推荐，逻辑倒置） #

若坚持要在零售商页面创建用户，需调整模型结构，让CustomUser包含指向Retailer的一对一字段（但这不符合用户作为基础身份的逻辑）：

# 调整后的模型（不推荐）
class Retailer(models.Model):
    store_name = models.CharField(max_length=100)
    address = models.TextField(blank=True)

class CustomUser(AbstractUser):
    phone = models.CharField(max_length=11, blank=True)
    retailer = models.OneToOneField(Retailer, on_delete=models.CASCADE, related_name='user')

对应的Admin配置：

class CustomUserInline(admin.StackedInline):
    model = CustomUser
    can_delete = False
    verbose_name_plural = '用户账号'
    extra = 1

class RetailerAdmin(admin.ModelAdmin):
    inlines = (CustomUserInline,)

admin.site.register(Retailer, RetailerAdmin)
admin.site.register(CustomUser)

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