NextJS+DRF外键模型POST/GET实现及GET接口加载慢排查

接口耗时过长由两个核心问题导致：

• 序列化逻辑出现无限递归：MySourceSerializer的to_representation方法动态嵌套了完整的DocumentSerializer，而DocumentSerializer本身又嵌套了MySourceSerializer(many=True)，形成Document→序列化关联MySource→每个MySource回查序列化Document→Document再次序列化所有关联MySource的死循环，关联数据量稍大就会产生巨量序列化计算。
• 存在N+1查询缺陷：当前视图层查询Document时没有预加载关联数据，序列化阶段每访问一条关联的question_blocks或mysource记录都会单独发起一次SQL查询，关联数据越多查询次数呈线性上涨，进一步拖慢响应。

1. 移除递归序列化逻辑 #

根据给出的期望返回结构，mysource列表项不需要返回完整的Document嵌套信息，直接删除MySourceSerializer中多余的to_representation方法，同时调整document字段支持读写，满足POST关联需求：

class MySourceSerializer(serializers.ModelSerializer):
    document = serializers.PrimaryKeyRelatedField(
        pk_field=HashidSerializerCharField(source_field="documents.Document.id"),
        queryset=Document.objects.all()
    )
    class Meta:
        model = MySource
        fields = ("id", "url", "title", "publisher", "desc", "summary", "document")

同时调整DocumentSerializer，将mysource字段设为只读（创建Document时不需要同步提交MySource数据，避免校验报错）：

class DocumentSerializer(serializers.ModelSerializer):
    id = HashidSerializerCharField(source_field="documents.Document.id", read_only=True)
    question_blocks = QuestionBlockSerializer(many=True)
    mysource = MySourceSerializer(many=True, read_only=True)

    class Meta:
        model = Document
        fields = "__all__"

    def create(self, validated_data):
        question_blocks = validated_data.pop("question_blocks")
        document = Document.objects.create(**validated_data)
        for qBlock in question_blocks:
            QuestionBlock.objects.create(document=document, **qBlock)
        return document

2. 配置查询预加载解决N+1问题 #

在Document对应的视图类中，使用prefetch_related一次性预加载所有关联数据，将多次零散SQL查询合并为固定3次查询：

# 以ModelViewSet为例，根据实际的视图类型调整即可
class DocumentViewSet(viewsets.ModelViewSet):
    serializer_class = DocumentSerializer
    queryset = Document.objects.prefetch_related("question_blocks", "mysource").all()

3. 开放MySource提交接口 #

直接为MySource配置对应的创建接口，即可支持传入document ID提交关联资源：

class MySourceViewSet(viewsets.ModelViewSet):
    serializer_class = MySourceSerializer
    queryset = MySource.objects.all()

• 序列化层级固定为「Document→关联QuestionBlock列表+关联MySource列表」，无递归嵌套
• 单Document详情查询SQL次数固定为3次，不会随关联数据量上涨，响应速度恢复到毫秒级
• GET Document详情返回结构完全匹配预期，POST MySource接口可正常通过传入document ID完成关联

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