Django笔记应用表单提交报错：Field 'id'期望数字却得到Category对象

问题排查：Field 'id' expected a number but got <Category: Django> #

这个错误的核心是外键字段的赋值/查询逻辑错误——Django的外键字段默认期望接收关联模型的主键（通常是数字类型的id），但你的代码里传入了Category对象本身，导致类型不匹配。

常见出错场景及修复方案 #

先假设你的核心模型结构如下（基于需求推断）：

from django.db import models

class Category(models.Model):
    name = models.CharField(max_length=100, unique=True)

    def __str__(self):
        return self.name

class Topic(models.Model):
    category = models.ForeignKey(Category, on_delete=models.CASCADE)
    title = models.CharField(max_length=200)
    notes = models.TextField()

1. 视图层逻辑错误

如果你的视图是类似下面的错误写法：

# 错误示例：将Category对象传给需要主键id的字段
def add_note(request):
    if request.method == 'POST':
        category_name = request.POST.get('category')
        category, created = Category.objects.get_or_create(name=category_name)
        # 错误：category_id需要数字id，却传入了Category对象
        topic = Topic(category_id=category, title=request.POST.get('topic'), notes=request.POST.get('notes'))
        topic.save()

修复方案：二选一即可

# 方式1：直接关联Category对象（推荐）
topic = Topic(category=category, title=request.POST.get('topic'), notes=request.POST.get('notes'))
# 方式2：传入Category对象的主键id
topic = Topic(category_id=category.id, title=request.POST.get('topic'), notes=request.POST.get('notes'))

2. 表单类定义错误

如果表单把Category字段定义为普通CharField，却直接将字符串赋值给外键字段：

# 错误表单定义
class NoteForm(forms.Form):
    category = forms.CharField(max_length=100)
    topic = forms.CharField(max_length=200)
    notes = forms.CharField(widget=forms.Textarea)

修复方案：用ModelForm并添加数据清洗逻辑，自动将输入的分类名称转为Category对象

class NoteForm(forms.ModelForm):
    class Meta:
        model = Topic
        fields = ['category', 'topic', 'notes']
    
    # 重写category字段为输入框，支持创建新分类
    category = forms.CharField(max_length=100)
    
    def clean_category(self):
        category_name = self.cleaned_data['category']
        category, _ = Category.objects.get_or_create(name=category_name)
        return category

视图中直接调用form.save()即可，无需额外处理分类逻辑。

3. 模板数据传递错误

如果模板中错误地将Category对象直接传给表单字段：

<!-- 错误示例：传递Category对象的字符串表示 -->
<input type="hidden" name="category" value="{{ category }}">

提交后request.POST.get('category')会得到<Category: Django>这类字符串，而非分类名称或id，导致后续处理出错。

修复方案：传递分类名称或主键id

<!-- 正确：传递分类名称 -->
<input type="hidden" name="category" value="{{ category.name }}">
<!-- 或传递分类id -->
<input type="hidden" name="category_id" value="{{ category.id }}">

快速定位错误的技巧 #

查看报错回溯的最后几行，找到类似File "views.py", line X, in Y的条目，检查该行中涉及Category和外键操作的代码，确认是否存在「将对象当作id使用」或「将字符串当作对象传入」的情况。

避免此类错误的Django学习资源推荐 #

官方文档类 #

• 模型字段文档：重点研读ForeignKey、unique约束的用法，明确外键字段的赋值规则（可传对象或主键id）；
• 表单文档：掌握Form与ModelForm的差异，学会用clean_xxx方法处理自定义数据转换；
• 数据库查询文档：熟悉get_or_create、filter等方法的返回值和参数要求。

实战教程类 #

• 官方入门Polls教程：完整走完模型创建、表单处理、视图逻辑的流程，掌握基础规范；
• 模型关系专题教程：深入学习一对多、多对多关系的正确用法，理解关联数据的操作逻辑；
• 表单进阶教程：重点学习表单验证、自定义字段的实现，避免数据类型不匹配问题。

调试技巧类 #

• Django Shell：用python manage.py shell测试模型查询、赋值逻辑，提前发现类型错误；
• 打印调试：在视图中打印关键变量的类型和值，比如print(type(category), category)，确认数据格式是否符合预期；
• 开发模式错误页：利用Django自带的错误页面，查看详细调用栈和变量信息，快速定位出错代码。

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