使用Django Rest Auth与Allauth开发自定义注册表单时出现save()参数不匹配报错
问题根因
你碰到的save() takes 1 positional argument but 2 were given报错,来自两层实现的错位:
- 你直接把原生继承
serializers.ModelSerializer的通用用户CRUD序列化器,配置成了django-rest-auth注册接口的专属序列化器。但django-rest-auth的注册视图在调用序列化器保存方法时,会将request对象作为位置参数传入save()方法;而DRF原生序列化器的默认save()方法签名是save(self, **kwargs),仅接受关键字参数,不支持额外的位置参数,因此直接触发参数数量不匹配的报错。 - 你为了适配参数要求,自行在通用序列化器里写了空的
save(self, request)方法覆盖父类逻辑,既没有实现实际的用户创建流程,也破坏了通用用户接口原有的save调用逻辑,会导致后续所有依赖该序列化器的接口都出现异常。
正确的修改方案
核心思路是拆分序列化器职责,严格遵循django-rest-auth的注册序列化器继承约定,不自行从零拼接save方法的参数逻辑。
- 清理通用用户序列化器的错误实现
把你之前写的那个空的def save(self, request):方法完全删掉,保留原本的create、update、Meta配置不变——这个序列化器是给用户个人信息查询、修改接口用的,不需要适配注册流程的参数签名,用DRF原生的默认save逻辑就可以正常运行。# 修正后的通用UserSerializer class UserSerializer(serializers.ModelSerializer): """Serializer for the users object""" class Meta: model = get_user_model() fields = ('email', 'password', 'name', 'age') extra_kwargs = {'password': {'write_only': True, 'min_length': 5}} def create(self, validated_data): """Create a new user with encrypted password and return it""" return get_user_model().objects.create_user(**validated_data) def update(self, instance, validated_data): """Update a user, setting the password correctly and return it""" password = validated_data.pop('password', None) user = super().update(instance, **validated_data) if password: user.set_password(password) user.save() return user - 单独编写注册专用的序列化器
不要复用通用CRUD序列化器做注册流程,直接继承django-rest-auth提供的注册序列化器基类RegisterSerializer,这个基类已经帮你实现了适配视图调用的save(self, request)方法签名、邮箱格式校验、密码强度校验、默认用户创建逻辑,你只需要把自定义字段的处理逻辑追加进去即可,不需要自己手写参数兼容逻辑。# serializers.py 新增注册专用序列化器 from rest_auth.registration.serializers import RegisterSerializer class CustomRegisterSerializer(RegisterSerializer): # 声明自定义的用户字段,和你的User模型字段保持一致 name = serializers.CharField(max_length=255) age = serializers.IntegerField(min_value=0, required=False) # 把自定义字段加入校验后的合法数据集合 def get_cleaned_data(self): cleaned_data = super().get_cleaned_data() cleaned_data['name'] = self.validated_data.get('name', '') cleaned_data['age'] = self.validated_data.get('age') return cleaned_data # 重写save流程,在原有基类创建用户的逻辑上,补充自定义字段赋值 def save(self, request): # 调用基类的save方法,已经自动完成用户创建、密码加密逻辑 user = super().save(request) user.name = self.cleaned_data.get('name') user.age = self.cleaned_data.get('age') user.save() return user - 修正settings里的注册序列化器配置
不要把通用的UserSerializer指向注册配置项,要指向你新写的注册专用序列化器:# settings.py 修正后的配置 REST_AUTH_REGISTER_SERIALIZERS = { 'REGISTER_SERIALIZER': 'user.serializers.CustomRegisterSerializer' }
关键注意事项
- 不要在通用业务序列化器里随意覆盖DRF基类的save方法签名,DRF内部的save方法会自动合并校验通过的数据、处理更新/创建分支,自行修改参数签名会导致所有调用该序列化器的接口都出现参数不匹配的问题。
- 注册流程不需要重复实现密码加密、用户创建的逻辑:你自定义的UserManager里的
create_user已经处理了密码哈希,继承自RegisterSerializer的基类会自动调用对应模型的创建方法,和你的自定义User模型完全兼容,不需要额外重复写创建逻辑。 - 这个方案完全兼容allauth原有的邮箱验证、第三方登录流程,因为所有核心流程都是在基类逻辑上扩展的,没有改动核心的验证、邮件发送逻辑。
内容的提问来源于stack exchange,提问作者Mário Prada
相关产品推荐
相关产品推荐

