Django模型ForeignKey反向关联在Admin后台展示的最优实现方案

你已经在ForeignKey字段中配置了related_name='scheduled_emails_sent'，这是反向关联的核心入口，后续所有反向调用都使用该属性名即可，两种常用实现方式如下：

方案1：Admin内联展示（最优推荐，满足查看+编辑需求） #

直接在Client模型的Admin详情页嵌套展示所有关联的ScheduledEmail记录，支持直接查看、新增、编辑、删除关联邮件，是Django官方推荐的标准实现，仅需修改admin.py代码即可：

# admin.py 代码
from django.contrib import admin
from .models import Client, ScheduledEmail

# 定义邮件内联模块，TabularInline为表格样式，排版更紧凑适合多数据展示
class ScheduledEmailInline(admin.TabularInline):
    model = ScheduledEmail
    # 配置内联区域要显示的字段
    fields = ('subject', 'recipient_email', 'datetime_sent', 'sent', 'datetime_created')
    # 配置不可编辑的只读字段
    readonly_fields = ('datetime_created', 'datetime_sent')
    # 配置默认显示的空新增行数量，设为0则默认只展示已有记录
    extra = 0
    # 如需完全禁止在Client页面修改邮件，可取消下面两行注释
    # can_delete = False
    # max_num = 0

@admin.register(Client)
class ClientAdmin(admin.ModelAdmin):
    # Client列表页要展示的字段，可根据需求调整
    list_display = ('name', 'number', 'email', 'unique_num')
    # 注册内联模块，即可在Client详情页看到关联邮件
    inlines = [ScheduledEmailInline]

# 原有ScheduledEmail的Admin配置保留即可，不受影响
@admin.register(ScheduledEmail)
class ScheduledEmailAdmin(admin.ModelAdmin):
    list_display = ('recipient_name', 'subject', 'sent', 'recipient')

方案2：Client列表页自定义展示关联信息 #

如果只需要在Client的列表页快速查看关联邮件的统计/摘要信息，不需要进入详情页查看完整记录，可以自定义Admin只读字段实现：

@admin.register(Client)
class ClientAdmin(admin.ModelAdmin):
    # 新增自定义字段到列表显示项
    list_display = ('name', 'number', 'email', 'email_count', 'latest_email')

    # 自定义字段：返回该客户关联的邮件总数
    def email_count(self, obj):
        return obj.scheduled_emails_sent.count()
    email_count.short_description = '关联邮件总数'

    # 自定义字段：返回该客户最近的邮件主题
    def latest_email(self, obj):
        latest = obj.scheduled_emails_sent.order_by('-datetime_created').first()
        return latest.subject if latest else '无关联邮件'
    latest_email.short_description = '最近邮件主题'

    # 优化查询，避免N+1数据库查询问题，数据量大时必须加
    def get_queryset(self, request):
        return super().get_queryset(request).prefetch_related('scheduled_emails_sent')

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