Django多对多模型接口返回categories.Category.None问题求助

问题原因 #

你的Video模型中category是多对多字段，但序列化时未正确配置字段处理逻辑，导致DRF默认序列化行为无法输出正确的关联分类数据，从而出现"categories.Category.None"的异常显示。

解决方案 #

1. 配置正确的序列化器 #

你需要在VideoSerializer中明确指定category字段的序列化方式，以下是两种常用方案：

方案1：返回分类完整嵌套数据

先创建Category的序列化器，再在VideoSerializer中嵌套使用：

from rest_framework import serializers
from .models import Video
from categories.models import Category

class CategorySerializer(serializers.ModelSerializer):
    class Meta:
        model = Category
        # 按需选择需要返回的字段，比如id、name、category_slug等
        fields = ('id', 'name', 'category_slug')

class VideoSerializer(serializers.ModelSerializer):
    # many=True适配多对多关系，read_only=True表示仅用于序列化输出
    category = CategorySerializer(many=True, read_only=True)
    
    class Meta:
        model = Video
        # 可指定具体字段，或用__all__包含所有字段
        fields = '__all__'

方案2：仅返回分类ID列表

如果只需要关联分类的ID，直接使用PrimaryKeyRelatedField：

from rest_framework import serializers
from .models import Video

class VideoSerializer(serializers.ModelSerializer):
    category = serializers.PrimaryKeyRelatedField(many=True, read_only=True)
    
    class Meta:
        model = Video
        fields = '__all__'

2. 优化查询性能（推荐） #

为避免多对多关系引发的N+1查询问题，在视图的queryset中添加prefetch_related预加载关联数据：

class VideoListView(ListAPIView):
    queryset = Video.objects.all().prefetch_related('category')
    serializer_class = VideoSerializer

3. 命名规范建议（可选） #

多对多字段通常建议用复数命名（比如categories），更符合语义，修改后需执行数据库迁移：

# 修改Video模型中的字段
categories = models.ManyToManyField('categories.Category', blank=True)
# 同步修改序列化器和视图中的对应字段名

内容的提问来源于stack exchange，提问作者Aliyasir Naç