Django admin 如何在 Profile 中 inline 显示多表数据

2026-10-10支付老李

结论

Django admin 的标准 inline 无法直接在 Profile 编辑页显示或编辑 Registration 和 Payment。这两个模型关联的是 User，没有通过 ForeignKey 或 OneToOneField 直接关联 Profile。

可以根据实际需求选择以下方案：

将 Profile、Registration 和 Payment 都配置为 UserAdmin 的 inline。这种方式与当前数据模型最匹配。
如果必须保留 Profile 编辑页，可以使用只读字段或自定义表单展示相关数据。
如果业务上确实需要让 Registration 和 Payment 隶属于 Profile，可以调整模型关系。建立直接关联后，才能在 ProfileAdmin 中使用标准 inline。

为什么不能直接使用 inline

TabularInline 和 StackedInline 要求 inline 模型包含一个指向当前父模型的 ForeignKey 或 OneToOneField。

例如，模型关系如下：

class Profile(models.Model):
    user = models.OneToOneField(
        User,
        on_delete=models.CASCADE,
        related_name="profile",
    )


class Registration(models.Model):
    user = models.OneToOneField(
        User,
        on_delete=models.CASCADE,
        related_name="registration",
    )


class Payment(models.Model):
    user = models.ForeignKey(
        User,
        on_delete=models.CASCADE,
        related_name="payments",
    )

这三张表共同关联的父对象是 User：

User
├── Profile
├── Registration
└── Payment

Registration.user 和 Payment.user 都不指向 Profile，所以下面的配置无法正常工作：

class RegistrationInline(admin.StackedInline):
    model = Registration


@admin.register(Profile)
class ProfileAdmin(admin.ModelAdmin):
    inlines = [RegistrationInline]

Django admin 会检查 inline 模型和父模型之间是否存在直接关系。找不到对应的 ForeignKey 时，它会报告配置错误。虽然 Profile 和 Registration 可以通过 User 间接关联，但 admin 不会自动跨过这一层关系。

推荐方案：统一放到 UserAdmin

三个模型都直接关联 User，因此可以将它们统一配置到用户编辑页：

from django.contrib import admin
from django.contrib.auth import get_user_model
from django.contrib.auth.admin import UserAdmin as BaseUserAdmin

from .models import Payment, Profile, Registration

User = get_user_model()


class ProfileInline(admin.StackedInline):
    model = Profile
    extra = 0
    max_num = 1


class RegistrationInline(admin.StackedInline):
    model = Registration
    extra = 0
    max_num = 1


class PaymentInline(admin.TabularInline):
    model = Payment
    extra = 0


admin.site.unregister(User)


@admin.register(User)
class UserAdmin(BaseUserAdmin):
    inlines = [
        ProfileInline,
        RegistrationInline,
        PaymentInline,
    ]

进入某个 User 的 admin 页面后，就可以同时查看和编辑：

Profile details
Registration details
多条 Payment details

Profile 和 Registration 是 one-to-one 关系，适合使用 StackedInline，同时设置 max_num = 1。Payment 通常是一对多关系，使用 TabularInline 更方便。

如果项目已有自定义的 UserAdmin，不要再次注销和注册用户模型，直接将这些 inline 合并到现有配置即可。

必须在 Profile 页面展示时

如果必须从 Profile 页面进入，但不需要直接编辑关联数据，可以在 ProfileAdmin 中添加只读字段：

from django.contrib import admin
from django.utils.html import format_html, format_html_join

from .models import Profile, Registration


@admin.register(Profile)
class ProfileAdmin(admin.ModelAdmin):
    readonly_fields = (
        "registration_details",
        "payment_details",
    )

    fieldsets = (
        (None, {
            "fields": (
                "user",
                # 这里放 Profile 自身的其他字段
            ),
        }),
        ("Registration details", {
            "fields": ("registration_details",),
        }),
        ("Payment details", {
            "fields": ("payment_details",),
        }),
    )

    @admin.display(description="Registration")
    def registration_details(self, obj):
        try:
            registration = obj.user.registration
        except Registration.DoesNotExist:
            return "暂无 Registration 记录"

        return format_html(
            "ID: {}<br>状态: {}",
            registration.pk,
            registration.status,
        )

    @admin.display(description="Payments")
    def payment_details(self, obj):
        payments = obj.user.payments.all()

        if not payments:
            return "暂无 Payment 记录"

        return format_html_join(
            format_html("<br>"),
            "ID: {}，金额: {}，状态: {}",
            (
                (payment.pk, payment.amount, payment.status)
                for payment in payments
            ),
        )

这里的 status、amount 等字段只是示例，需要替换为实际模型中的字段。

代码中的反向查询：

obj.user.registration
obj.user.payments.all()

依赖模型里配置的以下名称：

related_name="registration"
related_name="payments"

如果没有设置 related_name，默认的反向访问名称通常需要写成：

obj.user.registration
obj.user.payment_set.all()

最终使用哪个名称，应以项目中的模型定义为准。

这种方式可以在 Profile 页面显示数据，但显示的内容不是 inline，无法像标准 inline 一样直接新增、删除或修改记录。如果需要编辑，可以添加链接，跳转到对应的 Registration 或 Payment 编辑页面。

另一种方案：调整模型关系

如果 Registration 和 Payment 在业务上确实属于 Profile，可以让它们直接关联 Profile：

class Registration(models.Model):
    profile = models.OneToOneField(
        Profile,
        on_delete=models.CASCADE,
        related_name="registration",
    )


class Payment(models.Model):
    profile = models.ForeignKey(
        Profile,
        on_delete=models.CASCADE,
        related_name="payments",
    )

建立直接关系后，就可以正常配置 inline：

class RegistrationInline(admin.StackedInline):
    model = Registration
    extra = 0
    max_num = 1


class PaymentInline(admin.TabularInline):
    model = Payment
    extra = 0


@admin.register(Profile)
class ProfileAdmin(admin.ModelAdmin):
    inlines = [
        RegistrationInline,
        PaymentInline,
    ]

不要只为调整 admin 页面布局而修改数据库关系。如果付款和注册信息在业务上属于用户，而不是用户资料，那么继续关联 User 更合适。这种情况下，可以在 UserAdmin 中集中展示，或者在 ProfileAdmin 中只读展示。

注意事项

不要重写 inline 的内部方法来强行绕过外键检查。Django inline 的保存、删除、权限判断和表单集管理都依赖真实的父子关系。伪造关系可能把数据关联到错误的用户。

Django admin 原生也不支持嵌套 inline，不能在 ProfileInline 中继续嵌套 RegistrationInline。如果页面需要跨模型编辑，可以使用自定义 ModelForm、自定义 admin view，或者第三方 nested inline 组件。第三方组件是否兼容，需要根据项目当前使用的 Django 版本单独确认。