如何为DRF的SerializerMethodField标注可空的Serializer返回类型？

你可以通过以下两种方式实现extend_schema_field标记返回类型为可空的Serializer：

方法一：使用typing.Optional结合Serializer #

确保你的drf_spectacular版本≥0.20.0，直接用Optional包裹Serializer类型即可：

from typing import Optional
from drf_spectacular.utils import extend_schema_field

@extend_schema_field(Optional[SegmentSerializer])
def get_segment(self, obj):
    segment = models.Segment.objects.filter(obj=obj)
    if segment.exists():
        return SegmentSerializer(segment.first()).data
    return None

方法二：手动构建可空的OpenAPI Schema #

如果版本不支持Optional语法，直接构造包含nullable=True的schema字典：

from drf_spectacular.utils import extend_schema_field

@extend_schema_field({
    'nullable': True,
    **SegmentSerializer().get_schema()
})
def get_segment(self, obj):
    segment = models.Segment.objects.filter(obj=obj)
    if segment.exists():
        return SegmentSerializer(segment.first()).data
    return None

注意：原代码未显式返回None，建议补充return None让逻辑更清晰，也让Schema的可空标注更贴合实际行为。

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