Django默认AuthenticationForm无法访问email、first_name字段及邮箱登录问题
问题根因
- Django内置的
AuthenticationForm仅定义username、password两个表单字段,不包含email、first_name等User模型对应的表单控件,模板中调用{{ form.emailaddress }}无对应字段可渲染。 - 该表单是独立的表单类,本身不映射User模型的全量字段,因此无法直接从form实例上获取email、first_name等非表单定义字段的内容。
- 该表单的默认校验逻辑为:将用户输入的账号值匹配User表的
username字段,不做email字段匹配,无法直接实现邮箱登录。
实现邮箱登录的操作步骤
1. 自定义适配邮箱登录的表单类
继承内置AuthenticationForm,重写字段定义与校验逻辑,完整代码如下:
from django import forms from django.contrib.auth.forms import AuthenticationForm from django.contrib.auth import get_user_model from django.core.exceptions import ValidationError User = get_user_model() class EmailLoginForm(AuthenticationForm): # 复用原有username字段的位置,定义为邮箱格式输入框 username = forms.EmailField( label="邮箱", widget=forms.TextInput(attrs={"class": "form-control", "placeholder": "请输入注册邮箱"}) ) def clean(self): email = self.cleaned_data.get("username") password = self.cleaned_data.get("password") if email and password: try: # 按邮箱值匹配对应用户 user = User.objects.get(email=email) except User.DoesNotExist: raise ValidationError("邮箱或密码错误") # 校验用户密码正确性 if not user.check_password(password): raise ValidationError("邮箱或密码错误") # 复用内置逻辑校验用户状态(是否激活、是否允许登录) if not self.confirm_login_allowed(user): raise ValidationError(self.error_messages["invalid_login"]) # 缓存匹配到的用户实例,供后续登录流程调用 self.user_cache = user return self.cleaned_data
2. 修改视图代码
将原有逻辑中实例化AuthenticationForm的位置全部替换为自定义的EmailLoginForm,同时修正原代码中拼写错误的登录方法(authlog为Django内置的login方法),调整后代码如下:
def login(request): if request.method == 'POST': form = EmailLoginForm(data=request.POST) if form.is_valid(): user = form.get_user() login(request, user) return redirect('home') else: messages.error(request, '邮箱或密码错误') return redirect('login') else: content = { 'form': EmailLoginForm() } return render(request, 'sign-in.html', content)
3. 修正模板渲染逻辑
原模板中调用{{ form.emailaddress }}为无效写法,替换为自定义表单中定义的username字段即可渲染出邮箱输入框,调整后代码片段:
<div class="input-group"> <span class="input-group-text" id="basic-addon1"><span class="fas fa-envelope"></span></span> {{ form.username }} </div> <div class="input-group"> <span class="input-group-text" id="basic-addon2"><span class="fas fa-unlock-alt"></span></span> {{ form.password }} </div>
注意:如果需要同时支持用户名、邮箱双渠道登录,只需在自定义表单的clean校验逻辑中,优先按用户名匹配用户,匹配失败再按邮箱匹配即可,无需改动User模型的核心结构。如果仅需要在登录页展示用户的email、first_name等非输入类信息,可直接将用户信息从视图传入模板上下文,无需从form实例上获取。
内容的提问来源于stack exchange,提问作者Reactoo
相关产品推荐
相关产品推荐

