Django含ForeignKey的模型与UpdateView测试失败求助

核心问题本质 #

当ForeignKey指定to_field为非主键字段（比如location_number）时，Django的ModelForm会默认使用该字段作为关联字段的提交值标识，而非模型的pk/id。测试时提交pk/id自然会触发"选项无效"的验证错误。

1. 修正测试用例的提交值 #

测试提交数据必须传递Location对象的location_number值，而非pk、id或对象本身：

# 测试用例示例
def test_update_project(self):
    # 先创建测试用的Location和Project
    location = Location.objects.create(location_number="LOC001", name="测试地点")
    project = Project.objects.create(name="原项目名", location=location)
    
    # 提交更新请求，location字段传location_number的值
    response = self.client.post(
        reverse("project-update", args=[project.pk]),
        data={
            "name": "更新后的项目名称",
            "location": "LOC001"  # 重点：这里必须是location_number的值
        }
    )
    
    # 断言更新成功
    self.assertEqual(response.status_code, 302)
    project.refresh_from_db()
    self.assertEqual(project.name, "更新后的项目名称")

2. 确认表单配置正确性 #

如果使用自定义ModelForm，无需手动修改关联字段，Django会自动继承模型ForeignKey的to_field设置：

class ProjectForm(forms.ModelForm):
    class Meta:
        model = Project
        fields = ["name", "location"]  # 自动处理location字段的to_field关联

如果手动定义了location字段，必须显式指定to_field_name与模型一致，否则会导致验证不匹配：

# 错误示例：手动定义但未指定to_field_name
location = forms.ModelChoiceField(queryset=Location.objects.all())  # 会默认用pk

# 正确示例
location = forms.ModelChoiceField(
    queryset=Location.objects.all(),
    to_field_name="location_number"  # 与模型ForeignKey的to_field保持一致
)

3. 排查UpdateView的自定义逻辑 #

如果重写了UpdateView的get_form_class或get_form方法，确保没有篡改location字段的查询集或to_field配置：

class ProjectUpdateView(UpdateView):
    model = Project
    fields = ["name", "location"]  # 直接用默认配置即可，无需额外修改
    
    # 错误示例：如果自定义查询集但过滤掉了目标Location，也会导致选项不存在
    # def get_form(self, form_class=None):
    #     form = super().get_form(form_class)
    #     form.fields['location'].queryset = Location.objects.filter(name__contains='无效过滤')
    #     return form

4. 验证Location对象的可用性 #

确保测试中使用的Location对象已正确保存到数据库，且未被逻辑删除（如果有相关逻辑）：

# 测试中可添加断言，确认Location存在
self.assertTrue(Location.objects.filter(location_number="LOC001").exists())

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