Django集成Mailchimp订阅功能时出现serializer_class相关AssertionError

你当前继承的GenericAPIView是DRF提供的通用视图类，强制要求视图类必须配置serializer_class属性，或者重写get_serializer_class()方法，你目前的代码中两个要求都没有满足，所以触发了该断言错误。

方案1：不使用序列化器，修改继承类（最简单快速） #

如果你的业务场景不需要用到序列化器的参数校验、序列化等能力，直接把继承的父类从GenericAPIView换成APIView即可，APIView没有序列化器的强制要求。
同时注意你的subscribe_email是类内方法，需要加静态方法装饰器才能直接通过类名调用，修改后的views.py代码如下：

from rest_framework.views import APIView # 导入APIView
# Mailchimp Settings
MAILCHIMP_API_KEY = settings.MAILCHIMP_API_KEY
MAILCHIMP_DATA_CENTER = settings.MAILCHIMP_DATA_CENTER
MAILCHIMP_LIST_ID = settings.MAILCHIMP_EMAIL_LIST_ID


class MailSubscriptionAPIView(APIView): # 把父类从GenericAPIView改成APIView

    @staticmethod # 加静态方法装饰器
    def subscribe_email(email):
        mailchimp = Client()
        mailchimp.set_config({
            "api_key": MAILCHIMP_API_KEY,
            "server": MAILCHIMP_DATA_CENTER
        })
        member_info = {
            "email_address": email,
            "status": "subscribed",
        }
        try:
            mailchimp.lists.add_list_member(MAILCHIMP_LIST_ID, member_info)
        except ApiClientError as error:
            print(error.text)

    def post(self, request, *args, **kwargs):
        email = request.data.get('email')
        if not email:
            return Response({"message": "邮箱参数不能为空"}, status=status.HTTP_400_BAD_REQUEST)
        self.subscribe_email(email)
        return Response({
                "status_code": status.HTTP_200_OK,
                "message": "Mail added to mailchimp"
            })

方案2：保留GenericAPIView，补充序列化器（更规范） #

如果需要对入参的邮箱格式做校验，建议保留GenericAPIView，补充对应的序列化器即可：
首先定义序列化器（可写在views.py或单独的serializers.py文件中）：

from rest_framework import serializers

class EmailSubscribeSerializer(serializers.Serializer):
    email = serializers.EmailField(required=True, help_text="订阅邮箱")

修改后的视图代码：

class MailSubscriptionAPIView(GenericAPIView):
    serializer_class = EmailSubscribeSerializer # 配置序列化器，解决报错

    @staticmethod
    def subscribe_email(email):
        mailchimp = Client()
        mailchimp.set_config({
            "api_key": MAILCHIMP_API_KEY,
            "server": MAILCHIMP_DATA_CENTER
        })
        member_info = {
            "email_address": email,
            "status": "subscribed",
        }
        try:
            mailchimp.lists.add_list_member(MAILCHIMP_LIST_ID, member_info)
            return True, None
        except ApiClientError as error:
            return False, error.text

    def post(self, request, *args, **kwargs):
        # 用序列化器自动校验参数合法性、邮箱格式
        serializer = self.get_serializer(data=request.data)
        serializer.is_valid(raise_exception=True)
        email = serializer.validated_data['email']
        success, err_msg = self.subscribe_email(email)
        if not success:
            return Response({"message": f"订阅失败：{err_msg}"}, status=status.HTTP_400_BAD_REQUEST)
        return Response({
                "status_code": status.HTTP_200_OK,
                "message": "Mail added to mailchimp"
            })

• 不要直接从request.data['email']取值，前端不传该参数时会触发KeyError，建议用request.data.get('email')或者用序列化器做参数校验
• Mailchimp调用出错时不要只打印日志，建议返回对应错误响应给前端，方便前端提示用户
• 可以给接口加频率限制，避免被恶意调用刷Mailchimp接口

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