DRF中ManyToManyField字段POST请求无法保存数据问题

问题根源 #

你遇到的问题核心在于嵌套序列化器不支持直接写入ManyToMany关系：

• 给嵌套序列化器加read_only=True时，DRF会完全忽略传入的关联数据，导致保存后这些字段为空；
• 去掉read_only=True后，嵌套序列化器期望接收完整的关联对象数据（而非ID列表），和你实际传入的ID数组不匹配，因此报错必填项错误。

解决方案 #

根据你的业务需求，分两种场景给出实现方式：

场景1：仅关联已存在的对象（传入ID列表） #

适合用户只能选择平台已有的fandom、配对、角色等标签的场景。

修改序列化器（serializer.py）

创建专用的创建序列化器，用PrimaryKeyRelatedField接收关联对象的ID列表，同时单独写一个读取序列化器用于返回关联对象详情：

from rest_framework import serializers
from .models import Fanfic, Fandom, Pairing, Hero, Tag

# 用于创建的序列化器：处理ID输入
class FanficSerializerCreate(serializers.ModelSerializer):
    fandoms = serializers.PrimaryKeyRelatedField(many=True, queryset=Fandom.objects.all())
    pairings = serializers.PrimaryKeyRelatedField(many=True, queryset=Pairing.objects.all())
    characters = serializers.PrimaryKeyRelatedField(many=True, queryset=Hero.objects.all())
    tags = serializers.PrimaryKeyRelatedField(many=True, queryset=Tag.objects.all())

    class Meta:
        model = Fanfic
        fields = ['id', 'user', 'title', 'fandoms', 'pairings', 'characters', 'translate', 'categories', 'end', 'relationships', 'tags', 'description', 'note', 'i_write_for', 'created', 'updated']

# 用于返回数据的序列化器：显示关联对象详情
class FanficSerializerRead(serializers.ModelSerializer):
    fandoms = FandomSerializer(many=True)
    pairings = PairingSerializer(many=True)
    characters = HeroSerializer(many=True)
    tags = TagSerializer(many=True)

    class Meta:
        model = Fanfic
        fields = ['id', 'user', 'title', 'fandoms', 'pairings', 'characters', 'translate', 'categories', 'end', 'relationships', 'tags', 'description', 'note', 'i_write_for', 'created', 'updated']

修改视图（views.py）

保存后用读取序列化器返回包含关联对象详情的数据：

from rest_framework import status
from rest_framework.response import Response
from .serializers import FanficSerializerCreate, FanficSerializerRead

# 原POST请求处理部分修改为：
if request.method == 'POST':
    serializer = FanficSerializerCreate(data=request.data)
    if serializer.is_valid():
        fanfic = serializer.save()
        # 用读取序列化器返回完整数据
        read_serializer = FanficSerializerRead(fanfic)
        return Response({'fanfic': read_serializer.data}, status=status.HTTP_201_CREATED)
    return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)

请求格式示例

确保请求体中关联字段传入ID数组：

{
    "user": 1,
    "title": "测试同人",
    "fandoms": [1, 3],
    "pairings": [2],
    "characters": [5],
    "tags": [4, 6],
    // 其他必填字段...
}

场景2：支持自动创建新的关联对象（传入名称列表） #

类似AO3的功能，用户可以输入新的fandom、标签，系统自动创建并关联。

修改序列化器（serializer.py）

重写create方法，手动处理关联对象的创建和关联逻辑：

from rest_framework import serializers
from .models import Fanfic, Fandom, Pairing, Hero, Tag

class FanficSerializerCreate(serializers.ModelSerializer):
    # 接收名称字符串列表
    fandoms = serializers.ListField(child=serializers.CharField(max_length=200))
    pairings = serializers.ListField(child=serializers.CharField(max_length=200))
    characters = serializers.ListField(child=serializers.CharField(max_length=200))
    tags = serializers.ListField(child=serializers.CharField(max_length=200))

    class Meta:
        model = Fanfic
        fields = ['id', 'user', 'title', 'fandoms', 'pairings', 'characters', 'translate', 'categories', 'end', 'relationships', 'tags', 'description', 'note', 'i_write_for', 'created', 'updated']

    def create(self, validated_data):
        # 取出关联字段数据并从validated_data中移除（避免创建Fanfic时报错）
        fandoms_names = validated_data.pop('fandoms')
        pairings_names = validated_data.pop('pairings')
        characters_names = validated_data.pop('characters')
        tags_names = validated_data.pop('tags')

        # 创建Fanfic主对象
        fanfic = Fanfic.objects.create(**validated_data)

        # 处理fandoms：获取或创建对象并关联
        for name in fandoms_names:
            fandom, _ = Fandom.objects.get_or_create(name=name)
            fanfic.fandoms.add(fandom)
        
        # 处理pairings
        for name in pairings_names:
            pairing, _ = Pairing.objects.get_or_create(name=name)
            fanfic.pairings.add(pairing)
        
        # 处理characters
        for name in characters_names:
            character, _ = Hero.objects.get_or_create(name=name)
            fanfic.characters.add(character)
        
        # 处理tags
        for name in tags_names:
            tag, _ = Tag.objects.get_or_create(name=name)
            fanfic.tags.add(tag)

        return fanfic

请求格式示例

请求体中传入名称数组：

{
    "user": 1,
    "title": "测试同人",
    "fandoms": ["原神", "崩坏：星穹铁道"],
    "pairings": ["钟离×达达利亚"],
    "characters": ["钟离"],
    "tags": ["甜文", "HE"],
    // 其他必填字段...
}

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