Django提交表单maca字段为空报ValueError，如何存为None到数据库

核心原因 #

报错是两个问题叠加导致的：

1. 模型中的maca字段默认null=False，数据库层面不允许存储NULL值
2. 表单ChoiceField在required=False且提交空值时，默认返回空字符串''，数值类型字段无法识别字符串类型的空值，触发类型错误

修复步骤 #

第一步：修改模型字段，允许存储NULL #

给PositiveSmallIntegerField添加null=True参数，让数据库支持存储NULL：

class Product(models.Model):
    class Maca(models.IntegerChoices):
        Yes = 1,
        No = 2,

    maca = models.PositiveSmallIntegerField(
        db_column='maca', 
        choices=Maca.choices,
        null=True  # 新增这行
    )

修改后需要执行makemigrations和migrate命令同步数据库结构。

第二步：处理表单空值转换，有三种可选方案 #

方案1：使用TypedChoiceField替换普通ChoiceField（最简便）

TypedChoiceField支持自定义类型转换规则和空值返回值，直接配置即可自动把空提交转为None：

class ProductForm(forms.ModelForm):
    maca = forms.TypedChoiceField(
        required=False, 
        choices=Product.Maca.choices, 
        widget=forms.RadioSelect(),
        coerce=int,  # 把提交的值转为整数
        empty_value=None  # 空提交时返回None
    )

方案2：自定义字段清洗方法

通过clean_maca钩子手动处理空值逻辑：

class ProductForm(forms.ModelForm):
    maca = forms.ChoiceField(required=False, choices=Product.Maca.choices, widget=forms.RadioSelect())

    def clean_maca(self):
        value = self.cleaned_data.get('maca')
        return value if value else None

方案3：直接从表单中排除该字段（适合完全不需要前端传值的场景）

既然业务场景下该字段不需要在前端展示，直接从表单字段列表里移除即可，避免接收无效的空值提交：

class ProductForm(forms.ModelForm):
    class Meta:
        model = Product
        exclude = ['maca']  # 排除maca字段

如果后续需要给maca赋值，可以在保存表单时先不提交到数据库，赋值完成后再保存：

if form.is_valid():
    product = form.save(commit=False)
    # 按需给maca赋值，比如product.maca = None
    product.save()

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