Django报错：Field 'id'期望数字却收到职位列表，求解决

核心原因 #

这个错误明确说明：你正在尝试将字符串列表（比如['Irrigation Engineer', 'Greenhouse Maintenance', 'Greenhouse Manager']）赋值给一个要求接收数字类型主键（id）的模型字段——通常是ForeignKey或OneToOneField，这类字段只能接收对应关联模型的实例，或者该实例的数字ID。

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

场景1：视图中直接使用前端传来的名称列表赋值 #

如果你的视图从前端接收了职位名称列表，直接传给外键字段，就会触发这个错误：

# 错误示例
def create_record(request):
    if request.method == 'POST':
        selected_positions = request.POST.getlist('position')
        # 错误：把名称列表传给需要单个实例/ID的外键
        record = Worker.objects.create(position=selected_positions)

修复方式：先通过名称查询对应的关联模型实例，再赋值：

def create_record(request):
    if request.method == 'POST':
        position_names = request.POST.getlist('position')
        # 查询匹配名称的Position实例
        position_instances = Position.objects.filter(name__in=position_names)
        
        # 如果是单外键（一个Worker对应一个Position）：
        # 确保只取一个实例（根据业务逻辑调整）
        record = Worker.objects.create(position=position_instances.first())
        
        # 如果是多对多关系（一个Worker对应多个Position）：
        # 先创建主实例，再用add()添加关联
        # record = Worker.objects.create(...)
        # record.position.add(*position_instances)

场景2：手动创建对象时混淆字段类型 #

在脚本或视图中手动创建对象时，错误传入名称列表：

# 错误示例
record = Worker(position=['Irrigation Engineer'])
record.save()

修复方式：传入关联模型实例或数字ID：

# 方式1：通过名称查询实例
target_position = Position.objects.get(name='Irrigation Engineer')
record = Worker(position=target_position)
record.save()

# 方式2：直接使用已知的ID
record = Worker(position_id=3)  # 假设对应职位的id是3
record.save()

场景3：表单类字段配置错误 #

如果使用Django表单，错误地用普通字符字段处理外键：

# 错误示例
class WorkerForm(forms.ModelForm):
    position = forms.CharField(widget=forms.SelectMultiple)
    class Meta:
        model = Worker
        fields = ['position']

修复方式：使用对应外键/多对多的表单字段：

class WorkerForm(forms.ModelForm):
    # 单外键用ModelChoiceField
    position = forms.ModelChoiceField(queryset=Position.objects.all())
    # 多对多关系用ModelMultipleChoiceField
    # position = forms.ModelMultipleChoiceField(queryset=Position.objects.all())
    class Meta:
        model = Worker
        fields = ['position']

排查建议 #

1. 定位报错栈中触发错误的代码行，直接查看该位置的字段赋值逻辑，确认传入值的类型。
2. 检查前端提交的数据：确认表单控件传递的是关联模型的ID，而不是名称；检查表单控件的name属性是否与模型字段名匹配。
3. 核对模型定义：确认出现错误的字段是ForeignKey/OneToOneField，而非CharField或ManyToManyField（如果是多对多，需用add()方法而非直接赋值）。

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