Django REST Framework嵌套序列化器失效，如何修复？

核心问题1：关联字段名不匹配 #

你的Course模型里，外键字段的related_name设置为CourseInstructorRelatedNAme，但在InstructorSerializer里却用了courses作为关联字段名——Django会根据related_name识别关联的反向查询集，这个不匹配会导致序列化时无法获取讲师的课程数据。

核心问题2：需求匹配偏差 #

你要的是展示每位讲师的课程数量，但当前代码返回的是讲师的所有课程详情，既不符合需求，还会浪费性能。

推荐修改方案（性能更优） #

1. 修改视图层，提前统计课程数量

在views.py的InstructorViewSet中，用annotate给讲师对象添加课程统计字段：

from django.db.models import Count

class InstructorViewSet(ModelViewSet):
    serializer_class = InstructorSerializer
    # 用annotate提前统计每个讲师的课程数，关联名要和模型里的related_name一致
    queryset = Instructor.objects.annotate(course_count=Count('CourseInstructorRelatedNAme'))

2. 修改序列化器，新增课程数字段

在Serializer.py的InstructorSerializer中，添加统计字段并指定返回字段：

class InstructorSerializer(ModelSerializer):
    # 新增course_count字段，read_only=True表示只序列化输出，不接收输入
    course_count = serializers.IntegerField(read_only=True)
    
    class Meta:
        model = Instructor
        # 明确列出需要返回的字段，包括新增的course_count
        fields = ['id', 'name', 'email', 'course_count']

备选方案（按需选择） #

如果不想修改查询集，也可以用SerializerMethodField在序列化时计算数量：

class InstructorSerializer(ModelSerializer):
    course_count = serializers.SerializerMethodField()
    
    # 定义获取数量的方法，obj是当前的Instructor对象
    def get_course_count(self, obj):
        return obj.CourseInstructorRelatedNAme.count()
    
    class Meta:
        model = Instructor
        fields = ['id', 'name', 'email', 'course_count']

额外规范建议 #

模型字段名尽量符合PEP8规范，比如把Course模型里的Title改成title，Instructor外键改成instructor，避免大小写混用带来的混淆：

class Course(models.Model):
    title = models.CharField(max_length=250)
    instructor = models.ForeignKey(Instructor, on_delete=models.CASCADE, related_name="courses")

这样后续代码里的关联查询可以直接用obj.courses，更易读。

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