使用Django Generic UpdateView单独渲染表单字段时必填字段报错

你遇到的问题核心是手动编写的表单输入标签缺少正确的name属性。Django的表单验证机制依赖字段的name属性与模型/表单字段名对应，当你提交表单时，服务器无法识别没有name的输入值，因此判定name字段未填写，触发必填错误。

方案1：为手动渲染的字段添加name属性 #

修改update.html中的表单字段，为每个input添加name属性（值对应表单字段的名称），同时完善label的for属性关联input的id，确保表单语义化：

{% extends 'base.html' %}

{% block title %}Location Update{% endblock %}

{% block content %}

<section>
    <div class="container">
        <h1>Location Update</h1>
        <div class="form-container">
            <form method="post">
                {% csrf_token %}
                {% if form.errors %}
                <div class="p-3 mb-3 border border-danger border-3 rounded">{{ form.errors }}</div>
                {% endif %}
                <div class="mb-3">
                    <label for="{{ form.name.id_for_label }}" class="form-label">Name</label>
                    <input type="text" class="form-control" name="{{ form.name.name }}" id="{{ form.name.id_for_label }}" value="{{ form.name.value|default:'' }}">
                </div>
                <div class="mb-3">
                    <input type="checkbox" class="form-check-input" name="{{ form.is_source.name }}" id="{{ form.is_source.id_for_label }}" {% if form.is_source.value %} checked {% endif %}>
                    <label for="{{ form.is_source.id_for_label }}">Source</label>
                </div>
                <div class="mb-3">
                    <input type="checkbox" class="form-check-input" name="{{ form.is_destination.name }}" id="{{ form.is_destination.id_for_label }}" {% if form.is_destination.value %} checked {% endif %}> 
                    <label for="{{ form.is_destination.id_for_label }}">Destination</label>
                </div>
                <input type="submit" class="btn btn-success mb-3" value="Save">
            </form>
        </div>
    </div>
</section>

{% endblock %}

方案2：利用Django表单字段渲染并自定义样式 #

更推荐的方式是直接渲染Django表单字段，同时通过attrs添加自定义样式，既能保留Django表单的自动验证、错误提示等功能，又能实现自定义布局：

步骤1：在视图中创建自定义表单

修改views.py，添加自定义表单类并关联到UpdateView：

from django import forms
from django.shortcuts import render
from django.urls import reverse_lazy
from django.views import generic
from .models import Location

class LocationUpdateForm(forms.ModelForm):
    class Meta:
        model = Location
        fields = ['name', 'is_source', 'is_destination']
        widgets = {
            'name': forms.TextInput(attrs={'class': 'form-control'}),
            'is_source': forms.CheckboxInput(attrs={'class': 'form-check-input'}),
            'is_destination': forms.CheckboxInput(attrs={'class': 'form-check-input'}),
        }

class LocationsListView(generic.ListView):
    model = Location
    template_name = 'locations/list.html'
    context_object_name = 'locations'

class LocationUpdateView(generic.edit.UpdateView):
    model = Location
    form_class = LocationUpdateForm  # 替换原有的fields配置
    context_object_name = 'location'
    template_name = 'locations/update.html'
    success_url = reverse_lazy('locations:list')

class LocationDeleteView (generic.edit.DeleteView):
    model = Location
    template_name = 'locations/confirm_delete.html'
    context_object_name = 'location'
    success_url = reverse_lazy('locations:list')

步骤2：简化模板渲染

修改update.html，直接渲染表单字段并自定义布局：

{% extends 'base.html' %}

{% block title %}Location Update{% endblock %}

{% block content %}

<section>
    <div class="container">
        <h1>Location Update</h1>
        <div class="form-container">
            <form method="post">
                {% csrf_token %}
                {% if form.errors %}
                <div class="p-3 mb-3 border border-danger border-3 rounded">{{ form.errors }}</div>
                {% endif %}
                <div class="mb-3">
                    <label for="{{ form.name.id_for_label }}" class="form-label">Name</label>
                    {{ form.name }}
                </div>
                <div class="mb-3">
                    {{ form.is_source }}
                    <label for="{{ form.is_source.id_for_label }}" class="form-check-label">Source</label>
                </div>
                <div class="mb-3">
                    {{ form.is_destination }}
                    <label for="{{ form.is_destination.id_for_label }}" class="form-check-label">Destination</label>
                </div>
                <input type="submit" class="btn btn-success mb-3" value="Save">
            </form>
        </div>
    </div>
</section>

{% endblock %}

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