Django中form.is_valid()误返回false：提示字段必填但POST有数据

提交任务编辑表单时，form.is_valid()返回False，页面提示错误！请修正以下错误：Description：该字段为必填项，但打印request.POST后能看到Description字段有数据。尝试关闭所有字段必填性后，提交会清空任务数据。

相关代码 #

views.py #

def task_edit(request, task_id, slug):
    """
    Display an individual task for editing.
    """
    # Retrieve the task instance
    task = get_object_or_404(Task, pk=task_id)
    # Retrieve the job instance
    job = get_object_or_404(Job, slug=slug)
    
    if request.method == "POST":
        # Print out the request.POST dictionary to inspect the data
        print(request.POST)
        
        # Initialize form with task instance and data from request
        add_task_form = AddTaskForm(data=request.POST, instance=task)
        
        if add_task_form.is_valid():
            # Save the form data to the task instance
            task = add_task_form.save(commit=False)
            task.job = job
            task.save()
            messages.success(request, 'Task Updated!')
            return HttpResponseRedirect(reverse('job_detail', args=[slug]))
        else:
            messages.error(request, 'Error updating task!')
    else:
        # Initialize form with task instance
        add_task_form = AddTaskForm(instance=task)

JS处理函数 #

// Handle click event for edit button
$(".edit-button").on("click", function() {
    console.log("Edit Task button clicked");

    var taskId = $(this).data("task_id");
    
    var description = $(this).data("description");
    var tradesRequired = $(this).data("trades-required");
    var tradesmanAssigned = $(this).data("tradesman-assigned");
    var timeRequired = $(this).data("time-required");
    var isCompleted = $(this).data("is-completed");
    var slug = $(this).data("slug");
    console.log(taskId);
    console.log(slug);
    console.log("Trades Required:", tradesRequired);

    // Populate the add_task_form fields with task details
    $("#id_form-0-description").val(description);
    // For trades_required, set the checkboxes based on the received data
    setTradesCheckboxes(tradesRequired);
    $("#id_form-0-tradesman_assigned").val(tradesmanAssigned);
    $("#id_form-0-time_required").val(timeRequired);
    // Set the is_completed checkbox based on the data
    $("#id_form-0-is_completed").prop("checked", isCompleted === "True");

    // Change the submit button name to indicate editing the task
    $("button[type='submit']").attr("name", "edit_task");
    $("button[type='submit']").addClass( "btn-edit" );
    // Show the add_task_form
    $("#add_task_form").show();
    addTaskButton.hide();
    editButtons.innerText = "Update";
    var url = `/tradesman/${slug}/edit_task/${taskId}/`;
    console.log("Edit URL:", url);
    taskForm.attr("action", `edit_task/${taskId}/`);
});

forms.py #

class AddTaskForm(forms.ModelForm):
    class Meta:
        model = Task
        fields = ('id', 'description', 'trades_required', 'time_required', 'is_completed')

提交数据与错误信息 #

request.POST内容 #

return (<QueryDict: {'csrfmiddlewaretoken': ['q5VHJpmQ9NASbSjMsfnilC2H1uwgsF61yoQVlvWOje9pNIumBHLRmVY5OLJ7WwJt'], 'form-TOTAL_FORMS': ['1'], 'form-INITIAL_FORMS': ['0'], 'form-MIN_NUM_FORMS': ['0'], 'form-MAX_NUM_FORMS': ['1000'], 'form-0-description': ['Remove old worktop'], 'form-0-trades_required': ['Ca'], 'form-0-time_required': ['1 hour'], 'form-0-id': [''], 'edit_task': ['']}>
)

表单错误信息 #

Error! Please correct the following errors:
Description:
This field is required.

问题原因与解决方法 #

核心问题 #

你的表单是**表单集（FormSet）**格式提交的（从form-0-description、form-TOTAL_FORMS这些字段名能看出来），但后端用普通ModelForm接收数据，两者字段命名规则不匹配，导致普通表单找不到description字段，只能识别form-0-description，因此提示必填错误。

解决步骤 #

1. 后端改用表单集处理提交数据
   修改views.py中的task_edit函数，使用modelformset_factory创建表单集类来处理：

   from django.forms import modelformset_factory
   
   def task_edit(request, task_id, slug):
       task = get_object_or_404(Task, pk=task_id)
       job = get_object_or_404(Job, slug=slug)
       # 创建Task的表单集类，限制只编辑单个实例
       TaskFormSet = modelformset_factory(Task, form=AddTaskForm, extra=0, max_num=1)
       
       if request.method == "POST":
           print(request.POST)
           # 用表单集初始化，传入queryset指定要编辑的task
           formset = TaskFormSet(request.POST, queryset=Task.objects.filter(pk=task_id))
           if formset.is_valid():
               # 保存表单集里的实例
               tasks = formset.save(commit=False)
               for t in tasks:
                   t.job = job
                   t.save()
               messages.success(request, 'Task Updated!')
               return HttpResponseRedirect(reverse('job_detail', args=[slug]))
           else:
               messages.error(request, 'Error updating task!')
       else:
           # 初始化表单集，传入要编辑的task
           formset = TaskFormSet(queryset=Task.objects.filter(pk=task_id))
       # 模板里要渲染formset而非单个form
       return render(request, 'your_template.html', {'formset': formset})
   

2. 前端调整表单渲染
   模板里需渲染表单集的管理字段和表单内容：

   <form id="add_task_form" method="post" action="{% url 'task_edit' task.id job.slug %}">
       {% csrf_token %}
       {{ formset.management_form }} <!-- 必须渲染表单集管理字段 -->
       {% for form in formset %}
           {{ form.as_p }}
       {% endfor %}
       <button type="submit" name="edit_task">Update</button>
   </form>
   

3. JS无需调整
   表单集渲染的字段ID和你当前JS用的id_form-0-description一致，不需要修改选择器。

为什么关闭必填性会清空数据？ #

普通ModelForm无法识别表单集格式的字段，保存时会将所有字段设为默认值（如空字符串），导致原有数据被覆盖清空。

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