Django Formset忽略字段初始值问题及临时解决办法

问题重现 #

定义了包含带初始值字段的表单MyForm，单独使用时一切正常，但通过formset_factory生成表单集后，提交字段默认值时，cleaned_data中该字段为空；修改值后提交则能正常获取到字段值。

相关代码 #

forms.py

from django import forms

class MyForm(forms.Form):
    my_field = forms.IntegerField(
        initial=10,
        widget=forms.NumberInput(
            {
                'class': 'form-control',
            }
        ),
        label='',
    )

views.py

from django.forms import formset_factory
from django.shortcuts import render

from myapp.forms import MyForm

def index(request):
    factory = formset_factory(MyForm)
    match request.method:
        case 'POST':
            formset = factory(request.POST)
            if formset.is_valid():
                print(formset.cleaned_data)
        case _:
            formset = factory()
    return render(request, 'index.html', {'formset': formset})

index.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
<form method="post">
    {% csrf_token %}
    {{ formset.management_form }}
    {% for form in formset %}
        {{ form }}
    {% endfor %}
    <button type="submit">Submit</button>
</form>
</body>
</html>

现象 #

• 不修改字段值直接提交，cleaned_data输出为[{}]，但request.POST中明确存在form-0-my_field: ['10']
• 将字段值改为5后提交，cleaned_data正常输出[{'my_field': 5}]

原因 #

Django表单集通过has_changed()方法判断字段是否需要纳入cleaned_data。当表单集初始化时未传入initial参数，form-INITIAL_FORMS会被设为0，表单无法识别字段定义的initial值为初始状态。此时提交值与字段initial相等时，has_changed()返回False，字段值不会被加入cleaned_data。

解决方案 #

方案1：初始化表单集时传入初始数据 #

在GET请求初始化表单集时，传入与字段初始值匹配的initial参数，让表单集正确识别初始状态：

case _:
    # 传入对应字段的初始数据
    formset = factory(initial=[{'my_field': 10}])

此方法是最规范的处理方式，能让表单集正常处理初始值的提交逻辑。

方案2：强制标记字段已更改 #

通过重写字段的has_changed方法，始终返回True，确保字段值无论是否变化都会被纳入cleaned_data：

class MyForm(forms.Form):
    my_field = forms.IntegerField(
        initial=10,
        widget=forms.NumberInput({'class': 'form-control'}),
        label='',
    )

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 强制字段标记为已更改
        self.fields['my_field'].has_changed = lambda *args: True

此方法简单直接，但会让表单始终认为字段已修改，适合临时场景。

方案3：自定义表单集补全初始值 #

通过自定义表单集的clean方法，手动将缺失的初始值补入cleaned_data：

from django.forms import BaseFormSet

class BaseMyFormSet(BaseFormSet):
    def clean(self):
        super().clean()
        for form in self.forms:
            # 若cleaned_data中无my_field，补入字段初始值
            if 'my_field' not in form.cleaned_data:
                form.cleaned_data['my_field'] = form.fields['my_field'].initial

# 在views中使用自定义表单集
factory = formset_factory(MyForm, formset=BaseMyFormSet)

此方法灵活性高，仅在表单验证阶段补值，不影响其他表单逻辑。

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