DRF序列化器关联字段sub_topics未填充数据问题

核心问题是Django外键的反向关联名称和序列化器声明的字段名不匹配：

• 你在SubTopic模型中定义指向Topic的外键字段时，没有手动指定related_name参数，Django会为外键自动生成默认反向关联属性，命名规则为小写关联模型名_set，对应这里的属性名是subtopic_set。
• 你在TopicSerializer中声明的嵌套序列化字段名为sub_topics，序列化器在模型实例上找不到同名属性，因此无法拉取关联的SubTopic数据，最终返回结果中该字段无内容。

二选一即可，推荐第一种方案，语义更清晰。

方案1：修改模型外键，显式指定反向关联名 #

给SubTopic的外键字段加上related_name='sub_topics'参数，和序列化器字段名对齐：

class SubTopic(Base):
    name = models.CharField(max_length=100, unique=True)
    display_name = models.CharField(max_length=100)
    # 新增related_name指定反向访问属性名
    topic = models.ForeignKey(Topic, on_delete=models.CASCADE, related_name='sub_topics')

该修改属于ORM层配置，不涉及数据库表结构变更，保存代码后直接生效，无需执行数据库迁移命令。

方案2：不修改模型，在序列化器中指定数据源 #

如果你不想调整模型代码，可以给嵌套序列化字段加source参数，指向Django默认生成的反向关联属性：

class TopicSerializer(serializers.ModelSerializer):
    # 通过source指定实际取值的属性名
    sub_topics = SubTopicSerializer(many=True, read_only=True, source='subtopic_set')

    class Meta:
        model = Topic
        fields = ('id', 'display_name', 'sub_topics')

修复后功能可正常运行，如果接口返回的Topic列表数据量较大，建议在视图查询时添加预加载配置，避免产生N+1查询问题：

# 以列表视图为例，使用prefetch_related一次性加载所有关联SubTopic数据
topic_queryset = Topic.objects.all().prefetch_related('sub_topics')
# 如果使用方案2，这里prefetch_related的参数改为'subtopic_set'

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