Django表单设置multipart/form-data后request.FILES为空如何解决

原因说明 #

request.FILES为空的常见原因如下：

• Django默认开启CSRF防护，你的表单未添加CSRF令牌，POST请求的文件数据被拦截丢失
• 直接用[]访问MultiValueDict，当上传字段为空时会直接抛出异常，且没有提前做非空校验
• 你当前表单的enctype属性配置正确，但如果有前端JS动态修改表单属性的逻辑，也可能导致属性失效

修复步骤 #

第一步：修改前端表单，补充CSRF令牌 #

更新createuser.html代码，在表单内添加CSRF token标签：

<form method="POST" enctype="multipart/form-data" action="">
    {% csrf_token %}
    <input type="file" name="myfile">
    <input type="submit">
</form>

第二步：修改后端逻辑，安全获取文件 #

修改views.py的文件获取逻辑，改用get()方法取值并增加非空判断：

# 替换原有的 myfile = request.FILES['myfile'] 代码段
myfile = request.FILES.get('myfile')
if myfile:
    print(myfile)
    # 此处补充你注释的文件存储逻辑，同时把文件赋值给CustomUser对应的字段
    # 假设CustomUser的文件字段名为user_file：post.user_file = myfile
else:
    # 可自定义未上传文件的处理逻辑，比如返回错误提示
    pass

额外注意 #

如果需要将上传文件关联到用户数据保存，需要先在CustomUser模型中添加对应文件字段，示例：

from django.db import models

class CustomUser(models.Model):
    # 原有其他字段省略
    user_file = models.FileField(upload_to='user_uploads/', null=True, blank=True)

赋值后调用post.save()时Django会自动处理文件存储和路径入库逻辑。

可选排查点 #

• 确认上传文件大小没有超过Django设置的FILE_UPLOAD_MAX_MEMORY_SIZE限制，过大会被直接拦截
• 确认提交时选中了有效文件，不要空提交文件字段
• 如果使用JS异步提交表单，确认序列化FormData时没有漏加文件字段

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