在单个ListAPIView中实现数据列表与导出的多序列化器分离

我有一个继承ListExportMixin与ListAPIView的API视图，该视图既用于网页数据展示，也支持将数据导出为XLS或PDF文件。当前展示与导出使用相同的序列化器字段，现在需要添加仅在导出文件中显示的字段，已经创建了包含所有原有字段及新增字段的SecondSerializer用于导出。

现有视图代码如下：

class MyDataListAPIView(ListExportMixin, ListAPIView):
    serializer_class = MySerializer
    permission_classes = [IsAuthenticated]
    pagination_class = StandardResultsSetPagination
    filter_backends = (filters.OrderingFilter,)
    queryset = MyModel.objects.all()
    ordering = '-created'
    ordering_param = 'ordering'
  
    export_fields = (
        'number',
        'issue_date_formatted',
        'due_date_formatted',
        'hearing_date',
        'status',
        'total_amount_formatted',
        'amount_received_formatted',
        'balance_formatted',
        'unapplied_amount_sum_display',
        'firm',
        'last_past_due_sent_on_formatted',
        'fee_amount_formatted',
        'payments_formatted',
    )
    column_header = {
        'titles': [
            
        ],
        'header_title': 'Statement of Services Rendered'
    }

希望数据列表展示时使用MySerializer，导出文件时使用SecondSerializer，该如何实现？

核心思路是重写视图的get_serializer_class方法，根据当前请求是否为导出操作动态切换序列化器，同时更新export_fields包含新增的导出专属字段。

修改后的完整代码如下：

class MyDataListAPIView(ListExportMixin, ListAPIView):
    # 移除固定的serializer_class，改为动态获取
    permission_classes = [IsAuthenticated]
    pagination_class = StandardResultsSetPagination
    filter_backends = (filters.OrderingFilter,)
    queryset = MyModel.objects.all()
    ordering = '-created'
    ordering_param = 'ordering'
  
    # 更新export_fields，加入SecondSerializer中的新增字段
    export_fields = (
        'number',
        'issue_date_formatted',
        'due_date_formatted',
        'hearing_date',
        'status',
        'total_amount_formatted',
        'amount_received_formatted',
        'balance_formatted',
        'unapplied_amount_sum_display',
        'firm',
        'last_past_due_sent_on_formatted',
        'fee_amount_formatted',
        'payments_formatted',
        # 添加导出专属的新增字段
        'new_export_field1',
        'new_export_field2',
    )
    column_header = {
        'titles': [
            # 按export_fields顺序填写对应表头文字（可选）
        ],
        'header_title': 'Statement of Services Rendered'
    }

    def get_serializer_class(self):
        # 判断是否为导出请求：ListExportMixin默认通过?export=xls/pdf触发
        if self.request.query_params.get('export') in ['xls', 'pdf']:
            return SecondSerializer
        # 非导出请求返回原序列化器
        return MySerializer

关键说明 #

1. 动态切换序列化器：get_serializer_class方法通过请求的export参数识别导出操作，返回对应的序列化器，完美区分网页展示和文件导出的序列化需求。
2. 同步导出字段：export_fields必须包含SecondSerializer中的所有字段（包括新增的导出专属字段），确保导出文件能完整输出目标数据。
3. 表头自定义：如果需要给导出文件设置中文表头，在column_header['titles']中按export_fields的顺序填写对应文字即可。

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