Django中ImageField上传照片未保存至数据库的问题排查

以下是项目配置代码：

models.py #

class Contact(models.Model):
    name = models.CharField(max_length=50, null=False, blank=False, unique=False)
    photo = models.ImageField(upload_to='static/photos/', null=True, blank=True)

    def __str__(self) -> str:
        return f'{self.photo}, {self.name}'

admin.py #

@admin.register(Contact)
class ContactAdmin(admin.ModelAdmin):
    list_display = ['id', 'name', 'photo']

forms.py #

class ContactForm(forms.Form):
    name = forms.CharField(required=True, label='Name')
    photo = forms.ImageField(required=False, label='Photo')

views.py #

def post(self, request:HttpRequest)->HttpResponse:
        form = ContactForm(request.POST)
        if form.is_valid():
            Contact.objects.create(name=form.cleaned_data['name'], photo=form.cleaned_data['photo']).save()

创建带照片的Contact记录后，后台仅显示name字段，照片路径为空，照片未保存到数据库，请问问题出在哪？

问题原因及修复方案 #

1. 表单初始化未传入文件数据 #

Django处理文件上传时，表单必须同时接收request.POST和request.FILES，你当前只传了request.POST，导致photo字段的数据根本没被表单捕获。

修改views.py代码：

def post(self, request:HttpRequest)->HttpResponse:
    # 必须传入request.FILES才能获取上传的文件
    form = ContactForm(request.POST, request.FILES)
    if form.is_valid():
        # create方法已自动保存，无需额外调用save()
        Contact.objects.create(
            name=form.cleaned_data['name'], 
            photo=form.cleaned_data['photo']
        )
    # 可添加表单无效的处理逻辑和返回响应

2. 前端表单缺少enctype属性 #

如果前端表单没有设置enctype="multipart/form-data"，浏览器无法正确发送文件数据到后端。确保表单标签如下：

<form method="post" enctype="multipart/form-data">
    {% csrf_token %}
    {{ form.as_p }}
    <button type="submit">提交</button>
</form>

3. 媒体文件配置不规范 #

你的ImageField设置了upload_to='static/photos/'，但Django推荐将上传文件存到独立的媒体目录，而非static目录。需要完善项目的媒体配置：

在settings.py中添加：

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

在项目根urls.py中添加媒体文件路由：

from django.conf import settings
from django.conf.urls.static import static

urlpatterns = [
    # 你的其他路由配置
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

同时修改models.py中的upload_to参数，去掉static/：

photo = models.ImageField(upload_to='photos/', null=True, blank=True)

4. 冗余的save()调用 #

Contact.objects.create()方法会直接将新对象写入数据库，不需要额外调用.save()，这部分代码可以删除，避免不必要的操作。

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