如何在Django Rest Framework中用SerializerMethodField返回原始外键字段列表？

我来帮你梳理下这个DRF序列化里的常见问题：

首先说你遇到的两个核心情况：

• 直接在Authors.book_set这类关联QuerySet上用serializers.ListSerializer()，默认会返回关联模型的所有字段，如果只想返回部分字段，这个方式就太冗余了。
• 想用serializers.SerializerMethodField处理多结果时，会发现它根本没有many=True参数——DRF确实不支持直接用SerializerMethodField(many=True)来批量处理多个对象。

不过别担心，我们可以通过自定义序列化方法来完美解决这个问题，核心就是在对应的get_xxx方法里手动遍历关联的查询集，逐个处理并组装成你想要的结果。

给你举几个实用的代码例子，一看就懂：

假设我们有基础模型：

from django.db import models

class Author(models.Model):
    name = models.CharField(max_length=100)

class Book(models.Model):
    title = models.CharField(max_length=200)
    author = models.ForeignKey(Author, on_delete=models.CASCADE, related_name='book_set')
    publication_year = models.IntegerField()

方案1：手动组装返回数据 #

如果只是需要少量字段，直接在方法里组装字典就行：

from rest_framework import serializers
from .models import Author

class AuthorSerializer(serializers.ModelSerializer):
    # 只定义SerializerMethodField，不用加任何many参数
    books = serializers.SerializerMethodField()

    class Meta:
        model = Author
        fields = ['name', 'books']

    def get_books(self, obj):
        # 遍历当前作者的所有书籍QuerySet
        return [
            {
                'title': book.title,
                'publication_year': book.publication_year
            }
            for book in obj.book_set.all()
        ]

方案2：用子序列化器复用逻辑 #

如果需要更规范的序列化（比如要做字段校验、复用序列化逻辑），可以先定义一个精简的Book子序列化器，再在方法里调用它：

from rest_framework import serializers
from .models import Author, Book

# 先定义只返回需要字段的子序列化器
class MiniBookSerializer(serializers.ModelSerializer):
    class Meta:
        model = Book
        fields = ['title', 'publication_year']

class AuthorSerializer(serializers.ModelSerializer):
    books = serializers.SerializerMethodField()

    class Meta:
        model = Author
        fields = ['name', 'books']

    def get_books(self, obj):
        # 用子序列化器处理整个QuerySet，记得加many=True
        return MiniBookSerializer(obj.book_set.all(), many=True).data

总结一下 #

• ListSerializer适合需要返回关联模型全量字段的场景，但灵活性不足；
• SerializerMethodField虽然不支持many=True，但通过在get_xxx方法里手动遍历QuerySet，不管是直接组装数据还是用子序列化器，都能实现自定义的多结果序列化需求。

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