如何在Django Admin面板中限制图片字段仅允许上传一张图片

问题背景 #

现有Django模型代码如下：

class Image(models.Model):
    title = models.CharField(("title"), max_length=50,blank=True)
    image = models.FileField(("image"), upload_to=generate_filename, max_length=100)
    def __str__(self):
        return self.title

当前Admin面板可多次添加该模型实例，需求是仅允许上传一张图片，并移除添加图片按钮。

实现步骤 #

1. 修改模型，确保单实例存在 #

重写模型的save方法，每次保存时自动删除其他所有实例，保证数据库中永远只有一张图片：

class Image(models.Model):
    title = models.CharField(("title"), max_length=50, blank=True)
    image = models.FileField(("image"), upload_to=generate_filename, max_length=100)

    def __str__(self):
        return self.title

    def save(self, *args, **kwargs):
        # 保存当前实例前，删除其他所有Image实例
        Image.objects.exclude(id=self.id).delete()
        super().save(*args, **kwargs)

2. 自定义Admin类，控制添加权限与页面跳转 #

在admin.py中自定义Admin类，实现两个核心逻辑：隐藏添加按钮、直接跳转到编辑页（若已有实例）：

from django.contrib import admin
from django.shortcuts import redirect
from .models import Image

class ImageAdmin(admin.ModelAdmin):
    def has_add_permission(self, request):
        # 仅当没有任何Image实例时，才允许添加
        return Image.objects.count() == 0

    def changelist_view(self, request, extra_context=None):
        # 若已有实例，直接跳转到该实例的编辑页面，跳过列表页
        if Image.objects.exists():
            obj = Image.objects.first()
            return redirect(
                f"{self.admin_site.name}:{self.model._meta.app_label}_{self.model._meta.model_name}_change",
                obj.id
            )
        # 没有实例时，显示正常的添加页面
        return super().changelist_view(request, extra_context)

admin.site.register(Image, ImageAdmin)

效果说明 #

• 首次进入Admin的Image管理页面时，会显示添加表单，允许上传第一张图片。
• 上传完成后，添加按钮会自动消失，再次进入该页面会直接跳转到已上传图片的编辑页面。
• 每次编辑保存图片时，旧的图片实例会被自动删除，始终只保留最新的一张。

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