Django Form的HiddenInput无法保存初始值，该如何解决？

问题原因 #

Django表单的initial参数仅在**首次渲染表单（GET请求）**时生效。当处理POST请求时，表单会优先使用POST提交的数据填充字段：

• 如果POST数据中不包含某个隐藏字段的值（比如模板未渲染该字段），CharField会默认填充空字符串''，BooleanField会默认填充False，而非你设置的initial值。
• 你的当前输出正好符合这个逻辑：foo作为普通字段大概率已在模板渲染，所以保留了初始值；而bar和is_true作为隐藏字段可能未被渲染，导致POST数据里没有它们，最终被填充默认空值。

解决方案 #

方案1：确保模板正确渲染所有隐藏字段 #

这是最直接的解决方式，只要在模板中渲染所有隐藏字段，提交时它们的初始值就会被包含在POST数据里。

修改test.html模板：

<form method="post">
    {% csrf_token %}
    {{ test_form.foo }}
    <!-- 必须渲染隐藏字段 -->
    {{ test_form.bar }}
    {{ test_form.is_true }}
    <button type="submit">提交</button>
</form>

提交后，bar的初始值"Bar"和is_true的初始值True会被作为表单数据提交，cleaned_data就能得到你期望的结果。

方案2：在视图中合并POST数据与初始值 #

如果不想依赖模板渲染（比如担心前端篡改值，或特殊场景下无法渲染字段），可以在处理POST请求时，手动将初始值与POST数据合并，POST数据优先级更高，缺失的字段用初始值填充。

修改views.py：

def test_view(request):
    # 定义初始值字典
    initial_data = {
        'foo': 'Foo',
        'bar': 'Bar',
        'is_true': True
    }
    if request.method == "POST":
        # 合并POST数据和初始值，POST数据覆盖初始值，缺失则用初始值
        form_data = initial_data.copy()
        form_data.update(request.POST.dict())
        test_form = TestForm(form_data)
        if test_form.is_valid():
            print(test_form.cleaned_data)
    else:
        # GET请求时使用初始值渲染表单
        test_form = TestForm(initial=initial_data)
    return render(request, "test.html", {"test_form": test_form})

方案3：在表单的clean方法中设置默认值 #

通过表单字段的clean方法，为缺失值的字段返回初始值。注意BooleanField的特殊处理：因为未提交时，Django会将其默认设为False，所以需要检查字段是否存在于POST数据中。

修改forms.py：

class TestForm(forms.Form):
    foo = forms.CharField(required=False, initial="Foo")
    bar = forms.CharField(required=False, initial="Bar", widget=forms.HiddenInput())
    is_true = forms.BooleanField(required=False, initial=True, widget=forms.HiddenInput())

    def clean_bar(self):
        # 如果bar字段无值，返回初始值
        bar_value = self.cleaned_data.get('bar')
        return bar_value or self.fields['bar'].initial

    def clean_is_true(self):
        # 检查is_true是否在POST数据中，不存在则返回初始值
        if 'is_true' not in self.data:
            return self.fields['is_true'].initial
        return self.cleaned_data.get('is_true')

这样即使POST数据中没有bar和is_true，表单也会返回你设置的初始值。

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