Django电商应用：如何实现单个商品变体的多图片上传功能？

嘿，我来帮你搞定这个Django电商里商品变体多图上传的问题！目前你的模型只支持单图，我们可以通过拆分模型、新增图片关联表的方式，轻松实现每个变体至少3张图的需求，具体步骤如下：

首先我们需要把商品、变体、图片拆分成独立的关联模型，这样能更灵活地管理多图：

from django.db import models

# 商品主模型（存储通用信息）
class Product(models.Model):
    title = models.CharField(max_length=120)
    price = models.DecimalField(decimal_places=2, max_digits=20)

    def __str__(self):
        return self.title

# 商品变体模型（存储颜色、尺寸等差异化属性）
class ProductVariant(models.Model):
    product = models.ForeignKey(Product, on_delete=models.CASCADE, related_name="variants")
    color = models.CharField(max_length=50)  # 比如红色、绿色
    size = models.CharField(max_length=20, blank=True, null=True)  # 可选的尺寸属性

    def __str__(self):
        return f"{self.product.title} - {self.color}"

# 变体图片模型（专门存储每个变体的多张图片）
class ProductVariantImage(models.Model):
    variant = models.ForeignKey(ProductVariant, on_delete=models.CASCADE, related_name="images")
    image = models.ImageField(upload_to="product_variants/")
    is_primary = models.BooleanField(default=False)  # 标记主图，用于商品列表页展示

    class Meta:
        verbose_name_plural = "商品变体图片"

    def clean(self):
        # 可选：验证每个变体至少有一张主图
        if self.is_primary:
            existing_primary = ProductVariantImage.objects.filter(variant=self.variant, is_primary=True).exclude(id=self.id)
            if existing_primary.exists():
                raise ValidationError("每个变体只能设置一张主图")
        super().clean()

    def __str__(self):
        return f"{self.variant}的图片"

用Django的inlineformset_factory创建表单集，强制要求至少上传3张图：

from django import forms
from .models import ProductVariant, ProductVariantImage

class ProductVariantImageForm(forms.ModelForm):
    class Meta:
        model = ProductVariantImage
        fields = ["image", "is_primary"]

# 创建表单集：限制最少3张，最多10张，默认显示3个空表单
ProductVariantImageFormSet = forms.inlineformset_factory(
    ProductVariant,
    ProductVariantImage,
    form=ProductVariantImageForm,
    min_num=3,
    extra=3,
    max_num=10,
    validate_min=True,
    can_delete=True
)

在后台添加内联表单，方便管理员直接给变体上传多张图片：

from django.contrib import admin
from .models import Product, ProductVariant, ProductVariantImage
from .forms import ProductVariantImageFormSet

class ProductVariantImageInline(admin.TabularInline):
    model = ProductVariantImage
    formset = ProductVariantImageFormSet
    extra = 3

class ProductVariantAdmin(admin.ModelAdmin):
    inlines = [ProductVariantImageInline]

admin.site.register(Product)
admin.site.register(ProductVariant, ProductVariantAdmin)
admin.site.register(ProductVariantImage)

在模板中可以这样遍历某个变体的所有图片：

{% for variant in product.variants.all %}
    <div class="product-variant">
        <h4>{{ variant.color }} {% if variant.size %}({{ variant.size }}){% endif %}</h4>
        <div class="variant-images">
            {% for image in variant.images.all %}
                <img src="{{ image.image.url }}" alt="{{ product.title }} - {{ variant.color }}" 
                     class="{% if image.is_primary %}primary-image{% endif %}">
            {% endfor %}
        </div>
    </div>
{% endfor %}

• 如果你的现有模型已经有变体数据，记得先做数据迁移：把原来的单图数据批量导入到新的ProductVariantImage表中，再删除旧的图片字段。
• 可以自定义upload_to路径，比如按商品ID、变体颜色分目录，方便图片管理：upload_to=lambda instance, filename: f"products/{instance.variant.product.id}/{instance.variant.color}/{filename}"

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