如何在单个Django queryset中实现多图片上传存储

Django原生ImageField仅支持单张图片存储，不想通过外键关联独立图片表的话，可通过以下两种方案实现单条模型实例（单个QuerySet记录）存储多张图片，和Facebook单条帖子多图的效果完全对齐：

方案1：使用ArrayField存储多张图片路径（PostgreSQL环境推荐） #

如果使用PostgreSQL作为数据库，可以直接用官方内置的ArrayField嵌套ImageField实现，所有图片路径都存在主表的单个字段中，不会产生额外子表ID。

模型层代码 #

from django.db import models
from django.contrib.postgres.fields import ArrayField

class Post(models.Model):
    title = models.CharField(max_length=200)
    content = models.TextField()
    # 数组存储多张图片路径，size参数可限制最多上传张数，这里设为9和Facebook多图上限对齐
    images = ArrayField(
        models.ImageField(upload_to="post_images/"),
        size=9,
        blank=True,
        null=True
    )
    created_at = models.DateTimeField(auto_now_add=True)

表单层代码 #

from django import forms
from .models import Post

class PostForm(forms.ModelForm):
    # 覆写字段为多文件上传控件
    images = forms.ImageField(widget=forms.ClearableFileInput(attrs={"multiple": True}), required=False)
    
    class Meta:
        model = Post
        fields = ["title", "content", "images"]
    
    def save(self, commit=True):
        instance = super().save(commit=False)
        if self.cleaned_data.get("images"):
            # 直接把多文件列表赋值给ArrayField
            instance.images = self.cleaned_data["images"]
        if commit:
            instance.save()
        return instance

• 该方案仅支持PostgreSQL数据库，MySQL、SQLite不支持原生ArrayField
• 模板渲染时直接遍历post.images即可输出所有图片
• 模板的form标签需要添加enctype="multipart/form-data"属性才能正常接收多文件

方案2：使用JSONField存储多张图片路径（全数据库兼容） #

如果不使用PostgreSQL，可通过JSONField存储图片路径数组，兼容所有Django支持的数据库。

模型层代码 #

from django.db import models

class Post(models.Model):
    title = models.CharField(max_length=200)
    content = models.TextField()
    # 存储结构为["path1.jpg", "path2.jpg"]，也可自定义存储图片宽高、描述等额外信息
    images = models.JSONField(default=list, blank=True)
    created_at = models.DateTimeField(auto_now_add=True)

    # 封装单张图片添加方法，可直接调用简化逻辑
    def add_image(self, image_file):
        from django.core.files.storage import default_storage
        file_path = default_storage.save(f"post_images/{image_file.name}", image_file)
        self.images.append(file_path)
        self.save()

表单层代码 #

class PostForm(forms.ModelForm):
    images = forms.ImageField(widget=forms.ClearableFileInput(attrs={"multiple": True}), required=False)
    
    class Meta:
        model = Post
        fields = ["title", "content", "images"]
    
    def save(self, commit=True):
        instance = super().save(commit=False)
        image_files = self.files.getlist("images")
        if image_files:
            from django.core.files.storage import default_storage
            image_paths = []
            for img in image_files:
                path = default_storage.save(f"post_images/{img.name}", img)
                image_paths.append(path)
            instance.images = image_paths
        if commit:
            instance.save()
        return instance

• 优势是无数据库依赖，自定义扩展空间大
• 删除单张图片时直接修改JSONField的数组元素，调用save()即可更新

通用注意事项 #

• 上传前需要新增校验逻辑，限制图片的格式、大小、上传数量，避免存储非法文件
• 生产环境建议搭配对象存储服务使用，避免本地存储扩容、迁移问题

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