Django登录表单提交后异常出现id_username字段问题排查

• 核心问题是提交表单后的请求返回了Django内置的AuthenticationForm实例，该表单默认自带username字段，和你自定义的LoginForm无关。
• 最高频触发场景是urls.py导入错误：路由配置中使用的LoginView是django.contrib.auth.views下的内置登录视图，而非你在views.py中定义的自定义视图。内置LoginView默认使用AuthenticationForm，首次访问时可能因缓存、路由匹配优先级问题返回了自定义表单，POST提交时请求被分发到内置视图，就返回了带username字段的默认表单。
• 其他常见触发场景：
  • 自定义LoginView如果继承了Django内置的auth.LoginView，仅设置了form_class = LoginForm但未设置authentication_form = LoginForm，内置视图会优先读取authentication_form配置，未配置时在部分逻辑分支下回退到默认的AuthenticationForm。
  • 根路由中同时引入了django.contrib.auth.urls的默认登录路由，和自定义登录路由产生匹配冲突，POST请求被分发到内置登录视图。
  • 认证失败的逻辑分支中，意外实例化了AuthenticationForm返回，而非传入的自定义LoginForm实例。

1. 修正路由导入，确保使用自定义LoginView
   检查urls.py的导入语句，必须从当前app的views模块导入自定义的LoginView，不要导入Django内置的LoginView类，同时移除as_view()中重复的模板配置（类属性中已经定义过）：

   # urls.py 正确写法
   from django.urls import path
   # 从自己的视图文件导入，不要导入django.contrib.auth.views里的LoginView
   from .views import LoginView
   
   urlpatterns = [
       path('login/', LoginView.as_view(), name='login'),
   ]
   

2. 如果继承内置LoginView，必须指定authentication_form
   如果你需要复用内置LoginView的会话安全、暴力破解拦截能力，修改视图类的继承逻辑，优先指定authentication_form为自定义表单，同时补全认证失败的错误提示逻辑：

   # views.py 修改示例
   from django.contrib.auth.views import LoginView as BaseLoginView
   from django import forms
   from .forms import LoginForm
   
   class LoginView(BaseLoginView):
       # 内置LoginView优先读取该配置指定表单，不要只写form_class
       authentication_form = LoginForm
       success_url = '/about/'
       template_name = 'registration/login.html'
   
       def form_valid(self, form):
           request = self.request
           next_ = request.GET.get('next')
           next_post = request.POST.get('next')
           redirect_path = next_ or next_post or None
           email  = form.cleaned_data.get("email")
           password  = form.cleaned_data.get("password")
           user = authenticate(request, username=email, password=password)
           if user is not None:
               login(request, user)
               try:
                   del request.session['guest_email_id']
               except:
                   pass
               if is_safe_url(redirect_path, request.get_host()):
                   return redirect(redirect_path)
               else:
                   return redirect("/about/")
           # 认证失败时主动添加错误提示，避免空表单返回
           form.add_error(None, forms.ValidationError("邮箱或密码错误，请重试"))
           return self.form_invalid(form)
   

3. 排查路由冲突
   检查项目根urls.py，确保自定义的账号路由优先级高于Django内置的auth路由，如果不需要内置auth提供的重置密码、改密等默认路由，可以直接注释掉内置路由的引入：

   # 项目根urls.py 示例
   from django.urls import path, include
   
   urlpatterns = [
       # 自定义路由放在前面，优先匹配
       path('accounts/', include('accounts.urls')),
       # 不需要内置auth路由就注释下面这行，需要的话确保放在自定义路由后面
       # path('accounts/', include('django.contrib.auth.urls')),
   ]
   

4. 模板渲染优化
   你的模板中{{ form.as_p }}已经会自动渲染字段的label、input和错误提示，下方手动写的Your email、Passwordlabel会导致重复显示，建议要么完全使用{{ form.as_p }}渲染，要么手动遍历表单字段逐个渲染，不要混写。

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