Django BooleanField搭配RadioSelect时required=True验证异常问题

问题场景 #

模型定义了带choices的BooleanField：

class MyModel(models.Model):
    ...
    current_measures = models.BooleanField(
        verbose_name=_("Is there any control and safety measures?"),
        choices=BOOLEAN_CHOICE,
    )
    ...

对应的ModelForm中，为该字段使用自定义RadioSelect组件并设置required=True：

class MyForm(forms.ModelForm):
    ...
    current_measures = forms.BooleanField(
        widget=WidgetRadioSelectCustomAttrs(
            RADIO_WIDGET_ATTRS, choices=Risk.BOOLEAN_CHOICE
        ),
        label=_("Is there any control and safety measures?"),
        label_suffix="",
        required=True,
    )
    ...

提交False值时，表单触发ValidationError('Current measures is required')。调试发现：

• to_python方法将字符串"False"转为布尔值False
• validate方法判断not value and self.required为True，因此抛出错误：

def validate(self, value):
    if not value and self.required:
        raise ValidationError(self.error_messages["required"], code="required")

原因说明 #

这不是Django的Bug，是表单字段的设计逻辑与使用场景不匹配：

• Django的forms.BooleanField默认是为HTML复选框（<input type="checkbox">）设计的——复选框未勾选时不会提交任何值，所以required=True的逻辑是「必须提交True」，它把False等同于“未提供有效值”。
• 而你使用的是RadioSelect组件，会明确提交True/False字符串，这就和BooleanField的默认验证逻辑冲突了。

解决方案 #

方案1：改用TypedChoiceField（推荐） #

用forms.TypedChoiceField替代forms.BooleanField，通过coerce参数明确将提交的字符串转为布尔值，同时required=True会强制用户必须选择一个选项（True或False）：

class MyForm(forms.ModelForm):
    ...
    current_measures = forms.TypedChoiceField(
        widget=WidgetRadioSelectCustomAttrs(RADIO_WIDGET_ATTRS, choices=Risk.BOOLEAN_CHOICE),
        label=_("Is there any control and safety measures?"),
        label_suffix="",
        required=True,
        # 准确将提交的选项值转为布尔值
        coerce=lambda value: value in ('True', '1')
    )
    ...

方案2：自定义BooleanField并重写验证逻辑 #

如果坚持使用BooleanField，可以继承它并重写validate方法，只在值为None（未提交）时触发required错误：

class RequiredBooleanField(forms.BooleanField):
    def validate(self, value):
        # 仅当未提交任何值时才触发必填错误，False是合法值
        if value is None and self.required:
            raise ValidationError(self.error_messages["required"], code="required")

# 在表单中使用自定义字段
class MyForm(forms.ModelForm):
    ...
    current_measures = RequiredBooleanField(
        widget=WidgetRadioSelectCustomAttrs(
            RADIO_WIDGET_ATTRS, choices=Risk.BOOLEAN_CHOICE
        ),
        label=_("Is there any control and safety measures?"),
        label_suffix="",
        required=True,
    )
    ...

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