Django登录页面报错TypeError: BaseForm.__init__()意外收到request参数

我在使用Django开发认证页面（登录、注册等）时，编写登录程序遇到错误：TypeError: BaseForm.__init__() got an unexpected keyword argument 'request'，无法确定错误来源。

相关代码如下：

users/urls.py #

path('login/', CustomLoginView.as_view(), name='login'),

users/views.py #

class CustomLoginView(LoginView):
    form_class = AuthenticationForm
    template_name = 'users/login.html'

    # 临时修复以绕过错误
    def get_form_kwargs(self):
        """Return the keyword arguments for instantiating the form."""
        kwargs = super().get_form_kwargs()
        # 移除kwargs中的'request'参数（如果存在）
        kwargs.pop('request', None)
        return kwargs

users/form.py #

User = get_user_model()    
class AuthenticationForm(forms.Form):
    identifier = forms.CharField(max_length=100,
                               required=True,
                               widget=forms.TextInput(attrs={'placeholder': 'Username, Email, or Phone',
                                                             'class': 'form-control',
                                                             }))
    password = forms.CharField(max_length=50,
                               required=True,
                               widget=forms.PasswordInput(attrs={'placeholder': 'Password',
                                                                 'class': 'form-control',
                                                                 'data-toggle': 'password',
                                                                 'id': 'password',
                                                                 'name': 'password',
                                                                 }))
    remember_me = forms.BooleanField(required=False)

    def __init__(self, *args, **kwargs):
        print("Initialization arguments:", args, kwargs)  # 调试语句
        super().__init__(*args, **kwargs)

    def clean(self):
        identifier = self.cleaned_data.get('identifier')
        password = self.cleaned_data.get('password')

        if identifier and password:
            user = authenticate(username=identifier, password=password)
            if not user:
                try:
                    user = User.objects.get(email=identifier)
                    if not user.check_password(password):
                        raise forms.ValidationError("Invalid login credentials")
                except User.DoesNotExist:
                    # 尝试通过手机号认证
                    try:
                        user = User.objects.get(phone=identifier)
                        if not user.check_password(password):
                            raise forms.ValidationError("Invalid login credentials")
                    except User.DoesNotExist:
                        raise forms.ValidationError("Invalid login credentials")

            if user and not user.is_active:
                raise forms.ValidationError("This account is inactive.")

            self.cleaned_data['user'] = user
        return self.cleaned_data

    def get_user(self):
        return self.cleaned_data.get('user')

调试代码输出为：

Initialization arguments: () {'initial': {}, 'prefix': None, 'request': <WSGIRequest: GET '/users/login/'>}

通过临时修复可解决错误，但我想知道错误根源是什么？此外，这种同一字段支持用户名、邮箱或手机号登录的实现方式是否合理？

一、错误根源分析 #

Django内置的LoginView在实例化表单时，会通过get_form_kwargs()方法将request对象作为参数传递给表单的构造函数。但你自定义的AuthenticationForm继承的是基础的forms.Form，而非Django auth模块提供的django.contrib.auth.forms.AuthenticationForm——后者的构造函数专门做了兼容，支持接收request参数，而普通forms.Form的__init__方法并不支持该参数，因此触发了这个类型错误。

你的临时修复（移除request参数）能解决问题，更规范的处理方式有两种：

1. 让自定义表单兼容request参数：在表单的__init__方法里先弹出request参数再调用父类构造：

def __init__(self, *args, **kwargs):
    self.request = kwargs.pop('request', None)
    super().__init__(*args, **kwargs)

2. 保持当前的get_form_kwargs重写逻辑，不传递request参数。

二、多标识登录实现的合理性分析 #

这种同一字段支持用户名、邮箱、手机号登录的方式是合理且用户友好的，能降低用户登录门槛，无需让用户记忆或区分输入哪种标识。不过你的实现可以做一些优化：

• 减少数据库查询次数：当前代码先调用authenticate，再依次查询邮箱、手机号，最多触发3次数据库查询。可以用Q对象合并查询条件，一次查询找到匹配用户：

from django.db.models import Q

# 替换clean方法里的用户查询逻辑
user = User.objects.filter(Q(username=identifier) | Q(email=identifier) | Q(phone=identifier)).first()
if not user or not user.check_password(password):
    raise forms.ValidationError("Invalid login credentials")

• 遵循Django认证流程：更推荐自定义AuthenticationBackend，在后端的authenticate方法里处理多标识逻辑，而非在表单clean方法中实现，这样更符合Django的认证架构：

from django.contrib.auth.backends import ModelBackend

class MultiFieldAuthBackend(ModelBackend):
    def authenticate(self, request, username=None, password=None, **kwargs):
        try:
            user = User.objects.get(Q(username=username) | Q(email=username) | Q(phone=username))
            if user.check_password(password):
                return user
        except User.DoesNotExist:
            return None

然后在settings.py中配置：

AUTHENTICATION_BACKENDS = [
    'users.backends.MultiFieldAuthBackend',
    'django.contrib.auth.backends.ModelBackend',
]

• 错误提示安全性：当前所有错误返回统一提示，这是安全的，避免泄露用户账号是否存在的信息，建议保持这种做法。

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