Django使用单选按钮绑定文章分类报错要求Category实例如何解决

错误原因 #

Post模型的category是外键字段，必须接收Category实例或对应实例的主键值，你最初使用ChoiceField提交的是分类名字符串，Django无法直接将字符串转换为外键关联的实例，因此触发了ValueError。

推荐实现方案 #

不需要手动定义选项列表，直接使用Django内置的ModelChoiceField即可，它会自动处理选项拉取、校验、外键实例赋值的逻辑：

表单配置 #

# forms.py
class PostForm(forms.ModelForm):
    category = forms.ModelChoiceField(
        queryset=Category.objects.all(),
        widget=forms.RadioSelect, # 指定渲染为单选按钮
        # to_field_name="title"  # 需要用分类名作为提交值时打开这行
    )
    class Meta:
        model = Post
        fields = ['title', 'category']

模板配置 #

不需要手动写死单选按钮代码，直接渲染表单字段即可，Django会自动生成对应DOM结构：

<!-- template.html -->
{{ form.category }}

按分类名绑定的实现方法 #

如果要直接用分类的title字段作为提交值，只需要在ModelChoiceField中加上to_field_name="title"参数即可，注意要保证Category的title字段全局唯一，避免匹配到多个分类实例导致报错：

# 给Category的title字段加唯一约束
class Category(models.Model):
    title = models.CharField(max_length=255, verbose_name="Kategorie", unique=True)

此时手动写模板代码时，单选框的value直接填对应分类的title值即可正常提交。

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