Django实现单帖多图上传时图片无法存入数据库问题求解

你的多图上传无法入库是由3个核心错误导致的：

• 视图中处理POST请求的表单实例未传入request.FILES参数，表单无法获取任何上传的文件数据
• 表单中自定义的多图上传字段未设置required=False，无文件上传时会直接触发表单校验失败，阻断后续保存逻辑
• 开发环境未配置媒体文件路由映射，Django默认不会托管MEDIA路径下的上传文件，容易引发文件存储、访问异常

按以下模块替换对应代码即可：

models.py #

from django.db import models

class Project(models.Model):
    title = models.CharField(max_length=200)
    # 注：原代码字段名describtion为拼写错误，正确拼写为description；若已执行过数据库迁移，可保留原字段名避免报错
    description = models.TextField(null=True, blank=True)

class ProjectImage(models.Model):
    project = models.ForeignKey(Project, on_delete=models.CASCADE, related_name="project_images")
    # 替换为ImageField自动校验图片格式，upload_to单独设置目录方便后续维护
    image = models.ImageField(upload_to="project_images/")

forms.py #

from django import forms
from django.forms import ClearableFileInput
from .models import Project

class ProjectForm(forms.ModelForm):
    image = forms.ImageField(
        widget=ClearableFileInput(attrs={'multiple': True}),
        required=False # 设置非必填，无上传时不触发校验失败
    )
    class Meta:
        model = Project
        # 若保留原拼写错误的describtion字段，此处需对应改回原字段名
        fields = ['title', 'description']

views.py #

from django.shortcuts import render, redirect
from .forms import ProjectForm
from .models import ProjectImage

def createProject(request):
    if request.method == 'POST':
        # 必须同时传入request.POST和request.FILES才能接收到文本和文件数据
        form = ProjectForm(request.POST, request.FILES)
        images = request.FILES.getlist('image')
        if form.is_valid():
            project = form.save()
            # 循环批量保存所有上传的图片关联记录
            for img in images:
                ProjectImage.objects.create(project=project, image=img)
            # 保存成功后跳转，避免用户刷新页面重复提交
            return redirect('create-project')
    else:
        form = ProjectForm()
    
    context = {'form': form}
    return render(request, 'projects/project_form.html', context)

项目级urls.py #

添加开发环境下的媒体文件路由支持：

from django.contrib import admin
from django.urls import path, include
from django.conf import settings
from django.conf.urls.static import static

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', include('projects.urls')),
]

# 开发模式下托管MEDIA目录下的上传文件
if settings.DEBUG:
    urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

settings.py（可选优化） #

建议将媒体文件与静态文件目录隔离，避免资源混放：

STATIC_URL = '/static/'
# 媒体文件访问路径单独设置
MEDIA_URL = '/media/'

STATICFILES_DIRS = [
    BASE_DIR / 'static'
]

# 上传文件存储到独立的media目录
MEDIA_ROOT = os.path.join(BASE_DIR, 'media')
STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')

你的模板文件project_form.html已经正确添加了enctype="multipart/form-data"属性，不需要修改。
修改完模型后记得执行python manage.py makemigrations和python manage.py migrate生成数据库迁移文件并同步。

内容的提问来源于stack exchange，提问作者Phil Grütter