如何配置Django Admin实现单输入框多张图片上传？

你的序列化器已经实现了DRF接口的多图上传，但Django Admin默认不支持单框多文件上传，需要通过自定义表单和Widget来实现，具体步骤如下：

1. 自定义多文件上传组件 #

在应用的admin.py中，定义支持多文件选择的Widget和字段：

from django.contrib import admin
from django import forms
from django.forms import ClearableFileInput
from .models import Product, ProductImage

# 自定义支持多文件选择的输入框
class MultiFileInput(ClearableFileInput):
    allow_multiple_selected = True

# 自定义多文件字段
class MultiFileField(forms.FileField):
    def __init__(self, *args, **kwargs):
        kwargs.setdefault("widget", MultiFileInput())
        super().__init__(*args, **kwargs)

    def clean(self, data, initial=None):
        single_file_clean = super().clean
        # 处理多个文件的情况
        if isinstance(data, (list, tuple)):
            return [single_file_clean(d, initial) for d in data]
        else:
            return single_file_clean(data, initial)

2. 自定义Product的Admin表单 #

创建包含多文件上传字段的表单，保存时自动关联ProductImage：

class ProductAdminForm(forms.ModelForm):
    # 添加多文件上传字段
    uploaded_images = MultiFileField(label="上传多张图片", required=False)

    class Meta:
        model = Product
        fields = '__all__'

    def save(self, commit=True):
        # 先保存Product实例
        instance = super().save(commit=commit)
        # 如果有上传的图片，批量创建ProductImage记录
        if commit and self.cleaned_data.get('uploaded_images'):
            for image in self.cleaned_data['uploaded_images']:
                ProductImage.objects.create(product=instance, image=image)
        return instance

3. 配置Product Admin #

将自定义表单关联到ProductAdmin，并添加Inline展示已上传的图片：

# 定义Inline用于展示已关联的ProductImage
class ProductImageInline(admin.TabularInline):
    model = ProductImage
    extra = 0
    readonly_fields = ('image',)  # 设为只读避免重复编辑，按需调整

# 注册Product Admin
@admin.register(Product)
class ProductAdmin(admin.ModelAdmin):
    form = ProductAdminForm
    inlines = [ProductImageInline]
    # 可选：添加列表页显示字段
    list_display = ('name', 'price', 'category', 'date_created')

额外注意事项 #

• 确保settings.py中正确配置媒体文件路径：

  MEDIA_ROOT = BASE_DIR / 'media'
  MEDIA_URL = '/media/'
  

• 开发环境中，需在项目根路由添加媒体文件服务路由：

  from django.conf import settings
  from django.conf.urls.static import static
  
  urlpatterns = [
      # 其他路由
  ] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
  

• 如果Product模型中的image字段是冗余的（已通过ProductImage管理多图），建议移除该字段避免逻辑混淆。

内容的提问来源于stack exchange，提问作者Nelson Bolaños