Django自定义表单传图触发MultiValueDictKeyError: 'image'报错求助

错误原因总结 #

出现MultiValueDictKeyError: 'image'的核心原因有三个：

• 表单未配置文件上传必需的编码类型
• 图片上传输入框的HTML类型错误
• 视图中错误地从普通POST数据中获取文件对象

1. 修复模板文件（add_auction.html） #

两处关键修改：

• 表单标签添加enctype="multipart/form-data"属性（上传文件必须配置）
• 将图片输入框的type="image"改为type="file"（image类型是提交按钮，并非文件上传控件）

修改后的模板代码：

<h1>Add Listing</h1>
<form action="{% url 'add_auction' %}" method="POST" enctype="multipart/form-data">
    <div class="form-group">
        <label for="title">Title</label>
        <input type="text" class="form-control" id="title" name="title" placeholder="Title">
    </div>
    <div class="form-group">
        <label for="description">Description</label>
        <textarea class="form-control" id="description" name="description" rows="3"></textarea>
    </div>
    <div class="form-group">
        <label for="price">Price</label>
        <input type="number" step="0.01" class="form-control" id="price" name="price" placeholder="Price">
    </div>
    <div class="form-group">
        <label for="image">Image</label>
        <input type="file" class="form-control" id="image" name="image">
    </div>
    <div class="form-group">
        <label for="category">Category</label>
        <select class="form-control" id="category" name="category">
            <option value="1">Books</option>
            <option value="2">Clothing</option>
            <option value="3">Electronics</option>
            <option value="4">Furniture</option>
            <option value="5">Home</option>
            <option value="6">Toys</option>
            <option value="7">Vehicles</option>
            <option value="8">Other</option>
        </select>
        {% csrf_token %}
        <button type="submit" class="btn btn-primary">Submit</button>
</form>

额外优化：价格输入框改为type="number"并添加step="0.01"，更贴合金额输入场景

2. 修复视图文件（views.py） #

两处关键修改：

• 从request.FILES中获取图片文件（而非request.POST，文件数据单独存储在FILES中）
• 处理图片未上传的情况（模型中image字段允许为空）

修改后的视图代码：

def add_auction(request):
    if request.method == "POST":
        title = request.POST["title"]
        description = request.POST["description"]
        price = request.POST["price"]
        # 处理图片：从FILES获取，未上传则设为None
        image = request.FILES.get("image")
        category = request.POST["category"]
        user = request.user
        listing = listings(
            title=title, 
            description=description,
            price=price, 
            image=image, 
            category=category, 
            user=user
        )
        try:
            listing.save()
        except ValueError:
            return render(request, "auctions/add_auction.html", {
                "message": "Error adding auction."
            })
        return HttpResponseRedirect(reverse("index"))

    else:
        return render(request, "auctions/add_auction.html")

3. 模型文件（models.py）小修复 #

模型中blank和null参数应传入布尔值，而非字符串：

image = models.ImageField(upload_to='uploads/', blank=True, null=True)

验证修复 #

完成以上修改后，重启Django服务，使用自定义表单上传图片即可正常工作。Admin界面原本正常是因为Django自动为Admin表单配置了正确的enctype和文件处理逻辑。

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