Django Rest API实现Book序列化器添加首尾Chapter对象字段

第一步：定义Chapter序列化器 #

先定义一个Chapter序列化器，用于完整返回Chapter对象的所有所需字段：

from rest_framework import serializers
from .models import Book, Chapter

class ChapterSerializer(serializers.ModelSerializer):
    class Meta:
        model = Chapter
        fields = ['id', 'published_at', 'added_at', 'modified_at']  # 可根据需求调整字段列表

第二步：给Book序列化器添加自定义字段 #

方法1：使用SerializerMethodField（实现简单，注意N+1查询问题） #

直接在BookSerializer中添加两个SerializerMethodField，分别获取首个和最后一个章节：

class BookSerializer(serializers.ModelSerializer):
    first_chapter = serializers.SerializerMethodField()
    last_chapter = serializers.SerializerMethodField()

    class Meta:
        model = Book
        fields = ['id', 'title', 'description', 'published_at', 'added_at', 'modified_at', 'first_chapter', 'last_chapter']

    def get_first_chapter(self, obj):
        # 按published_at升序取第一个章节
        chapter = obj.chapters.order_by('published_at').first()
        return ChapterSerializer(chapter).data if chapter else None

    def get_last_chapter(self, obj):
        # 按published_at降序取第一个章节（即最后发布的章节）
        chapter = obj.chapters.order_by('-published_at').first()
        return ChapterSerializer(chapter).data if chapter else None

注意：这种写法会触发N+1数据库查询，如果数据量较大，建议用下面的性能优化方案。

方法2：使用Subquery和annotate（性能更优，支持排序） #

通过在Book的查询集中提前用Subquery标注出首个和最后一个章节，避免重复查询，同时支持基于嵌套字段排序：

from django.db.models import OuterRef, Subquery
from rest_framework import serializers
from .models import Book, Chapter

class BookSerializer(serializers.ModelSerializer):
    first_chapter = ChapterSerializer(read_only=True)
    last_chapter = ChapterSerializer(read_only=True)

    class Meta:
        model = Book
        fields = ['id', 'title', 'description', 'published_at', 'added_at', 'modified_at', 'first_chapter', 'last_chapter']

# 在视图层的get_queryset中添加标注逻辑
def get_queryset(self):
    # 子查询获取每个Book的第一个章节（按published_at升序）
    first_chapter_subquery = Chapter.objects.filter(book=OuterRef('pk')).order_by('published_at')[:1]
    # 子查询获取每个Book的最后一个章节（按published_at降序）
    last_chapter_subquery = Chapter.objects.filter(book=OuterRef('pk')).order_by('-published_at')[:1]

    return Book.objects.annotate(
        first_chapter=Subquery(first_chapter_subquery, output_field=serializers.ModelSerializer.serializer_field_mapping[Chapter])
    ).annotate(
        last_chapter=Subquery(last_chapter_subquery, output_field=serializers.ModelSerializer.serializer_field_mapping[Chapter])
    )

支持按嵌套字段排序 #

如果需要按first_chapter.published_at或last_chapter.published_at排序，可以在查询时先标注出对应字段的取值，再进行排序：

def get_queryset(self):
    # 子查询获取第一个章节的发布时间
    first_chapter_published = Chapter.objects.filter(book=OuterRef('pk')).order_by('published_at').values('published_at')[:1]
    # 子查询获取最后一个章节的发布时间
    last_chapter_published = Chapter.objects.filter(book=OuterRef('pk')).order_by('-published_at').values('published_at')[:1]

    first_chapter_subquery = Chapter.objects.filter(book=OuterRef('pk')).order_by('published_at')[:1]
    last_chapter_subquery = Chapter.objects.filter(book=OuterRef('pk')).order_by('-published_at')[:1]

    return Book.objects.annotate(
        first_chapter_published=Subquery(first_chapter_published),
        last_chapter_published=Subquery(last_chapter_published),
        first_chapter=Subquery(first_chapter_subquery, output_field=serializers.ModelSerializer.serializer_field_mapping[Chapter]),
        last_chapter=Subquery(last_chapter_subquery, output_field=serializers.ModelSerializer.serializer_field_mapping[Chapter])
    ).order_by('first_chapter_published')  # 按第一个章节发布时间升序排序

你之前的代码不生效的原因 #

你自定义的LastChapterField继承了RelatedField，但缺少必要的to_representation方法来处理对象的序列化逻辑；同时get_queryset的写法不符合RelatedField的设计预期——该类通常用于处理关联对象的选择或基础展示，而非直接获取子查询结果。上述两种方案可以正确返回完整的Chapter对象，解决字段不显示的问题。

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