如何在Django中循环处理多文件上传表单及存储文件信息？

现有场景 #

你当前的表单包含多个独立的文件输入框，视图仅支持单文件上传，需要改造为能处理任意数量的上传文件（0个、3个或其他数量），同时收集文件名用于后续写入数据库。

1. 核心：视图函数改造 #

直接修改视图，通过循环遍历所有上传文件，完成存储并收集文件信息：

from django.core.files.storage import FileSystemStorage
from django.shortcuts import render

def image_upload(request):
    uploaded_file_info = []  # 存储成功上传的文件信息，供后续写入数据库
    if request.method == "POST":
        fs = FileSystemStorage()
        # 遍历所有上传的文件对象
        for file in request.FILES.values():
            # 跳过用户未选择文件的空提交
            if file.size > 0:
                # 保存文件到FileSystemStorage指定的目录
                saved_filename = fs.save(file.name, file)
                # 获取文件访问URL
                file_url = fs.url(saved_filename)
                # 收集文件名和URL，按需调整字段
                uploaded_file_info.append({
                    'filename': saved_filename,
                    'url': file_url
                })
                print(f"已上传文件：{file_url}")
        
        # --- 这里添加写入数据库的逻辑 ---
        # 假设你有一个自定义的Image模型，示例代码：
        # from .models import Image
        # for info in uploaded_file_info:
        #     Image.objects.create(
        #         filename=info['filename'],
        #         image_url=info['url']
        #     )
        
        # 把上传结果传递给模板
        return render(request, "upload.html", {
            "uploaded_files": uploaded_file_info
        })
    return render(request, "upload.html")

代码说明 #

• uploaded_file_info列表专门用来存储每个成功上传的文件信息，方便后续批量写入数据库
• 用request.FILES.values()遍历所有上传的文件，自动覆盖表单里的image_file、image_file2等字段
• 判断file.size > 0是为了过滤用户点击了输入框但未选择文件的空提交
• FileSystemStorage.save()会自动处理文件名重复的情况（比如给重复文件名加后缀），避免文件覆盖

可选：仅处理指定前缀的文件字段

如果只想处理表单中以image_file开头的字段，可修改遍历逻辑：

for field_name in request.FILES.keys():
    if field_name.startswith('image_file'):
        file = request.FILES[field_name]
        if file.size > 0:
            # 保存逻辑同上
            saved_filename = fs.save(file.name, file)
            file_url = fs.url(saved_filename)
            uploaded_file_info.append({'filename': saved_filename, 'url': file_url})

2. 表单优化（可选） #

如果想让用户更方便地选择多个文件，可将多个独立输入框改为单个带multiple属性的输入框，上传数量完全灵活：

<form action="{% url "upload" %}" method="post" enctype="multipart/form-data">
  {% csrf_token %}
  <input type="file" name="image_files" multiple>
  <input type="submit" value="submit" />
</form>

对应的视图遍历逻辑改为：

for file in request.FILES.getlist('image_files'):
    if file.size > 0:
        # 保存逻辑同上

3. 关键注意事项 #

• 表单必须保留enctype="multipart/form-data"，否则文件无法正确上传
• 若需限制文件类型/大小，可在视图中添加额外判断（比如检查file.content_type是否为图片类型）
• 写入数据库时，根据你的模型结构调整uploaded_file_info中的字段即可

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