Django REST Framework ManyToMany字段序列化与数据提交异常问题

这个问题我之前也碰到过，本质是没搞清楚Django REST Framework（DRF）中ManyToMany字段的序列化与反序列化逻辑，咱们一步步来拆解解决：

问题根源分析 #

你遇到的两个问题其实是同一逻辑的两面：

1. 用原生ManyToMany序列化器提交数据验证失败：DRF对关联字段的反序列化需要明确的查询集（queryset）来验证提交的关联对象是否合法，没配置的话就会导致is_valid()返回False。
2. 换成JSONField后返回API报错：JSONField只是把数据存成JSON格式，但模型的b字段本质还是ManyToMany关联，查询时返回的是ManyRelatedManager对象——这玩意儿本身不是可JSON序列化的结构，所以返回响应时会炸。

正确的解决方案：定制序列化器处理ManyToMany #

下面是针对你的模型的完整解决方案，包含序列化、反序列化、保存的全流程：

1. 补全基础模型细节 #

from django.db import models

class B(models.Model):
    name = models.CharField(max_length=100)  # 补充必填的max_length参数

class A(models.Model):
    b = models.ManyToManyField(B)

2. 编写正确的序列化器 #

from rest_framework import serializers
from .models import A, B

# 先定义B的基础序列化器（用于序列化时展示详情）
class BSerializer(serializers.ModelSerializer):
    class Meta:
        model = B
        fields = ['id', 'name']

class ASerializer(serializers.ModelSerializer):
    # 核心：用PrimaryKeyRelatedField处理ManyToMany的双向逻辑
    # 序列化时返回关联B的id列表（或者换成BSerializer(many=True)返回详情）
    # 反序列化时验证提交的id是否存在于B的查询集中
    b = serializers.PrimaryKeyRelatedField(
        many=True,
        queryset=B.objects.all(),
        required=False  # 如果允许创建/更新时不传入b字段，就添加这个参数
    )

    class Meta:
        model = A
        fields = ['id', 'b']

    # 手动处理ManyToMany字段的创建逻辑（DRF默认不会自动处理）
    def create(self, validated_data):
        # 先从验证后的数据中取出b的关联实例列表，移除这部分数据
        b_instances = validated_data.pop('b', [])
        # 创建A的实例
        a_instance = A.objects.create(**validated_data)
        # 关联B实例
        a_instance.b.add(*b_instances)
        return a_instance

    # 手动处理ManyToMany字段的更新逻辑
    def update(self, instance, validated_data):
        # 如果提交了b字段，更新关联关系
        if 'b' in validated_data:
            b_instances = validated_data.pop('b')
            instance.b.set(b_instances)  # set()会替换原有关联，add()是追加逻辑
        # 更新其他普通字段
        for attr, value in validated_data.items():
            setattr(instance, attr, value)
        instance.save()
        return instance

3. 关键细节说明 #

• 反序列化验证通过的核心：PrimaryKeyRelatedField指定了queryset=B.objects.all()，DRF会自动验证你提交的每个id是否对应一个存在的B实例，所以is_valid()会返回True。
• 手动处理保存的原因：ManyToMany字段是多对多关联，需要先创建主模型（A）的实例，再通过add()/set()方法关联子模型（B），DRF默认不会帮你做这一步。
• 序列化时展示详情的可选方案：如果不想返回B的id，而是返回B的完整信息，把b = serializers.PrimaryKeyRelatedField(...)换成b = BSerializer(many=True, read_only=True)，然后在反序列化时单独加一个字段处理提交的id，比如：

  class ASerializer(serializers.ModelSerializer):
      b = BSerializer(many=True, read_only=True)
      b_ids = serializers.PrimaryKeyRelatedField(many=True, queryset=B.objects.all(), write_only=True, source='b')
  
      class Meta:
          model = A
          fields = ['id', 'b', 'b_ids']
  

  这样提交数据时用b_ids字段传id列表，返回时用b字段展示详情，更友好。

4. 测试提交的数据格式 #

提交创建A的请求时，JSON格式应该是这样的（使用已存在的B的id）：

{
    "b": [1, 3]
}

为什么之前的方法不行？ #

• 原生ManyToMany序列化器验证失败：如果你之前只是简单地在ASerializer里写b = BSerializer(many=True)，那这个字段默认是只读的，提交数据时DRF会忽略它；或者如果没指定queryset，就无法验证提交的数据合法性，导致is_valid()失败。
• JSONField的问题：JSONField是把数据存成JSON字符串，但模型的b字段还是ManyToMany关联，查询时返回的是ManyRelatedManager（一个管理器对象，不是JSON），所以DRF尝试序列化这个对象时就会抛出Object of type 'ManyRelatedManager' is not JSON serializable的错误。

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