Django Forms：更新表单时如何禁用必填字段shpid？

当表单字段设为disabled后，浏览器不会将该字段的值提交到后端，导致Django表单验证时认为必填的shpid字段缺失，从而抛出错误。以下是几种可行的解决方法：

方法一：前端禁用+同步隐藏字段 #

在前端显示禁用的shpid字段同时，添加一个同名的隐藏字段传递值，这样后端能接收到该字段的值，满足必填验证要求。

forms.py 代码示例 #

from django import forms
from crispy_forms.helper import FormHelper
from crispy_forms.layout import Layout, Field, Hidden
from .models import YourModel

class YourUpdateForm(forms.ModelForm):
    class Meta:
        model = YourModel
        fields = ['shpid', 'other_field1', 'other_field2']

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        self.helper = FormHelper()
        # 给shpid字段添加禁用属性
        self.fields['shpid'].widget.attrs['disabled'] = True
        # 配置表单布局，添加隐藏字段传递shpid值
        self.helper.layout = Layout(
            Field('shpid'),
            Hidden('shpid', value=self.instance.shpid),
            'other_field1',
            'other_field2'
        )

方法二：后端跳过验证并保留原有值 #

修改表单逻辑，将shpid设为非必填，然后在清洗数据阶段用实例原有值覆盖提交的空值，既满足前端禁用需求，又能通过验证。

forms.py 代码示例 #

from django import forms
from crispy_forms.helper import FormHelper
from .models import YourModel

class YourUpdateForm(forms.ModelForm):
    class Meta:
        model = YourModel
        fields = ['shpid', 'other_field1', 'other_field2']

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        self.helper = FormHelper()
        # 前端禁用字段
        self.fields['shpid'].widget.attrs['disabled'] = True
        # 后端取消字段必填要求
        self.fields['shpid'].required = False

    def clean(self):
        cleaned_data = super().clean()
        # 用实例原有shpid值填充清洗后的数据
        cleaned_data['shpid'] = self.instance.shpid
        return cleaned_data

方法三：表单排除字段，模板单独渲染显示 #

如果更新操作完全不需要修改shpid，可以直接在表单中排除该字段，然后在模板中手动渲染一个禁用的输入框显示原有值，这样表单验证不会涉及该字段，彻底避免报错。

forms.py 代码示例 #

from django import forms
from crispy_forms.helper import FormHelper
from .models import YourModel

class YourUpdateForm(forms.ModelForm):
    class Meta:
        model = YourModel
        # 排除shpid字段，不参与表单提交和验证
        exclude = ['shpid']

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        self.helper = FormHelper()
        # 配置其他字段的布局...

模板渲染示例 #

<!-- 手动渲染禁用的shpid字段 -->
<div class="form-group mb-3">
    <label class="form-label" for="id_shpid">SHPID</label>
    <input type="text" class="form-control" id="id_shpid" value="{{ form.instance.shpid }}" disabled>
</div>
<!-- 渲染crispy表单的其他字段 -->
{% crispy form %}

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