DRF序列化器元类重写引发非关联模型序列化异常

这个问题我之前也碰到过，核心是自定义元类SoftDeletionMetaclass带来的全局副作用，结合DRF序列化器的字段缓存机制导致的：

DRF的SerializerMetaclass在创建序列化器类时，会收集并缓存类的字段集合。当你定义CompanyBankAccountSerializer时，它同时继承了带自定义元类的SoftDeletionSerializer和AbstractBankAccountSerializer——你的元类逻辑可能在处理过程中，意外修改了AbstractBankAccountSerializer的全局字段缓存，给它添加了deleted字段。

而UserBankAccountSerializer继承自AbstractBankAccountSerializer，第一次初始化时会读取这个被污染的缓存字段，但UserBankAccount模型并没有deleted字段，所以触发ImproperlyConfigured错误；第二次执行时，可能因为序列化器实例的局部缓存或者元类的后续处理覆盖了错误状态，所以又恢复正常。

针对这个问题，推荐以下几种解决思路，按可靠性排序：

方案1：放弃元类，改用实例级别的字段处理（最推荐） #

元类虽然能减少重复代码，但容易产生跨类的全局副作用。我们可以直接在SoftDeletionSerializer的__init__方法里，针对当前实例动态处理字段，完全避免影响父类或其他序列化器：

from rest_framework import serializers

class SoftDeletionSerializer(serializers.ModelSerializer):
    class Meta:
        abstract = True

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 从当前实例的字段中移除deleted，仅对非管理员用户生效
        request = self.context.get('request')
        if request is not None and not request.user.is_staff:
            # pop方法加默认值，避免字段不存在时报错
            self.fields.pop('deleted', None)

这个方法只修改当前序列化器实例的fields字典，不会触及类级别的全局缓存，完全隔离了不同序列化器之间的影响。

方案2：修复自定义元类，避免修改父类字段缓存 #

如果你坚持要用元类实现，需要确保元类只修改当前序列化器类的字段，不污染父类的字段集合。核心是对当前类的字段进行拷贝后再处理：

from rest_framework.serializers import SerializerMetaclass

class SoftDeletionMetaclass(SerializerMetaclass):
    def __new__(cls, name, bases, attrs):
        # 先让父元类创建基础类
        new_class = super().__new__(cls, name, bases, attrs)
        
        # 关键：拷贝父类的字段集合，创建当前类的独立字段缓存
        new_class._declared_fields = new_class._declared_fields.copy()
        
        # 后续针对deleted字段的处理逻辑，只操作当前类的_declared_fields
        # 比如：根据权限控制字段的显示逻辑（可以放到__init__里，元类只负责字段的初始化隔离）
        return new_class

这样元类处理的是当前类的独立字段副本，不会影响父类AbstractBankAccountSerializer的全局字段缓存，UserBankAccountSerializer也就不会拿到不属于自己的deleted字段了。

方案3：调整继承顺序（临时 workaround） #

如果只是临时解决问题，可以调整CompanyBankAccountSerializer的继承顺序，把SoftDeletionSerializer放在继承列表的最后：

class CompanyBankAccountSerializer(AbstractBankAccountSerializer, SoftDeletionSerializer):
    # 你的序列化器逻辑
    class Meta:
        model = CompanyBankAccount
        fields = '__all__'

这个方法让DRF优先处理AbstractBankAccountSerializer的字段，再应用SoftDeletionSerializer的元类逻辑，能减少字段缓存被污染的概率，但不如前两个方案彻底，仍然存在潜在的元类副作用风险。

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