Django多对多关系仅在Admin单侧展示，如何让Subscriber页显示关联Tag

问题根因 #

你当前将多对多关联字段定义在了Tag模型中，Subscriber模型没有显式声明tags属性，所以访问Subscriber.tags会触发属性不存在的报错；你之前注释的代码报错是因为定义Subscriber时Tag类还未完成声明，用字符串包裹类名即可触发Django的延迟解析解决该问题。

方案1（推荐，后续代码调用更便捷） #

第一步：修改Models.py #

调整多对多字段定义，不影响原有Tag侧的使用逻辑：

from django.db import models
from accounts.models import Account


class Subscriber(models.Model):
    first_name = models.CharField(max_length=100)
    last_name = models.CharField(max_length=100, null=True, blank=True)
    email = models.CharField(max_length=100, null=True)
    # 取消注释，用字符串包裹Tag避免未定义报错，related_name和原Tag侧的字段名保持一致，不影响原有功能
    tags = models.ManyToManyField('Tag', blank=True, related_name='subscribers')
    date_joined = models.DateTimeField(auto_now_add=True, null=True)
    verified = models.BooleanField(default=False)
    account = models.ForeignKey(
        Account, on_delete=models.CASCADE)

    def __str__(self):
        return self.email


class Tag(models.Model):
    name = models.CharField(max_length=100)
    # 删掉Tag侧的多对多定义，related_name已经自动给Tag生成subscribers反向属性，原有功能不受影响
    # subscribers = models.ManyToManyField(Subscriber, blank=True)

    def __str__(self):
        return self.name

修改后执行makemigrations命令，出现「是否重命名字段」的提示时选择y确认，原有多对多关联数据会完整保留，再执行migrate同步数据库即可。

第二步：修改Admin.py #

将tags字段加入SubscriberAdmin的表单字段配置，可搭配filter_horizontal提升多选体验：

from django.contrib import admin
from subscribers import models


@admin.register(models.Subscriber)
class SubscriberAdmin(admin.ModelAdmin):
    list_display = ("first_name", "email",
                    "date_joined", "verified", "account")
    # 新增配置，tags仅会显示在订阅者详情页，不会出现在列表页
    fields = ("first_name", "last_name", "email", "tags", "date_joined", "verified", "account")
    # 可选：添加下面这行用横向多选框更便于操作
    filter_horizontal = ("tags",)


@admin.register(models.Tag)
class TagAdmin(admin.ModelAdmin):
    list_display = ("name", )
    # 保留Tag侧原有的订阅者展示逻辑即可
    filter_horizontal = ("subscribers",)

方案2（不需要修改模型定义） #

如果不想调整现有模型结构，可以直接使用Django自动生成的反向关联名tag_set配置Admin：

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


@admin.register(models.Subscriber)
class SubscriberAdmin(admin.ModelAdmin):
    list_display = ("first_name", "email",
                    "date_joined", "verified", "account")
    
    # 自定义表单字段，引入反向多对多关系
    def get_form(self, request, obj=None, **kwargs):
        form = super().get_form(request, obj, **kwargs)
        form.base_fields['tag_set'] = forms.ModelMultipleChoiceField(
            queryset=models.Tag.objects.all(),
            widget=admin.widgets.FilteredSelectMultiple('标签', is_stacked=False),
            required=False
        )
        return form
    
    # 保存时处理反向关联
    def save_model(self, request, obj, form, change):
        super().save_model(request, obj, form, change)
        obj.tag_set.set(form.cleaned_data['tag_set'])
    
    # 配置详情页展示字段
    fields = ("first_name", "last_name", "email", "tag_set", "date_joined", "verified", "account")

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