Django Rest Framework报TypeError：期望主键却获dict的400错误求助

嘿，我来帮你搞定这个缠人的问题！你遇到的这个400错误，在Django Rest Framework里几乎都是序列化器处理关联字段时的格式不匹配导致的——DRF期望收到主键ID，结果前端传了一个完整的对象字典，自然就报错了。咱们一步步排查解决：

1. 先检查你的序列化器字段定义 #

如果你的MenuConfig模型关联了其他模型（比如外键、一对一字段），序列化器里的字段设置很可能是问题根源：

• 如果你用了嵌套序列化器（比如RelatedModelSerializer()）来序列化关联对象，那更新时DRF会默认期望收到主键值，而不是整个对象字典。
• 如果你用了PrimaryKeyRelatedField，但前端传的不是纯ID，也会触发这个错误。

修复示例： #

情况1：只需要传递主键更新关联关系

把嵌套序列化器改成主键字段：

from rest_framework import serializers
from .models import MenuConfig, RelatedModel

class MenuConfigSerializer(serializers.ModelSerializer):
    # 把嵌套序列化器替换为主键字段
    related_model = serializers.PrimaryKeyRelatedField(queryset=RelatedModel.objects.all())

    class Meta:
        model = MenuConfig
        fields = '__all__'

情况2：需要支持嵌套对象更新

如果前端必须传完整的对象字典来更新关联数据，那你需要重写序列化器的update方法，手动处理字典数据：

class MenuConfigSerializer(serializers.ModelSerializer):
    related_model = RelatedModelSerializer()

    class Meta:
        model = MenuConfig
        fields = '__all__'

    def update(self, instance, validated_data):
        # 取出关联对象的数据
        related_data = validated_data.pop('related_model', None)
        if related_data:
            # 根据ID获取关联实例，或者创建/更新它
            related_instance, _ = RelatedModel.objects.get_or_create(
                id=related_data['id'],
                defaults=related_data
            )
            instance.related_model = related_instance
        # 保存当前实例
        instance.save()
        # 调用父类方法处理其他字段
        return super().update(instance, validated_data)

2. 检查前端Vue的PATCH请求数据格式 #

这是最常见的坑！前端很容易不小心把整个关联对象传过去，而不是只传主键ID：

错误示例： #

// 错误：传了完整的related_model对象字典
axios.patch('/api/menu-config/1/', {
  name: '更新后的菜单名称',
  related_model: { id: 2, name: '关联模型名称' }
})

正确示例： #

// 正确：只传关联对象的主键ID
axios.patch('/api/menu-config/1/', {
  name: '更新后的菜单名称',
  related_model: 2
})

3. 额外排查点 #

• 确认你的MenuConfigViewSet使用的是正确的序列化器类，有没有在get_serializer_class里动态切换导致的问题。
• 如果是批量更新，检查是不是批量处理时的单个数据项格式错误。

按照上面的步骤排查，应该就能解决这个问题啦！

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