如何在Django中重写默认认证表单并让LoginView使用自定义表单

你完成AuthenticationForm子类的编写后，选以下任意一种方式配置即可生效，不需要修改框架源码。

方式1：路由层直接传参（最轻量化） #

Django内置的LoginView提供了authentication_form类属性用来指定认证表单类，你不需要额外写视图，直接在urls.py的路由注册时给as_view()传入这个参数就行：

# 你的路由文件 urls.py
from django.urls import path
from django.contrib.auth.views import LoginView
# 导入你自己写的自定义认证表单
from .forms import CustomAuthenticationForm

urlpatterns = [
    # 其他路由...
    path(
        "login/",
        LoginView.as_view(
            # 核心配置：指定你的自定义表单
            authentication_form=CustomAuthenticationForm,
            # 其他LoginView常规配置可以正常写，比如自定义模板、登录后跳转地址
            template_name="account/login.html",
            redirect_authenticated_user=True,
            success_url="/user/dashboard/"
        ),
        name="login"
    ),
]

注意：这里不要把参数名错写成form_class，LoginView不会读取form_class属性加载认证表单，必须用authentication_form传参。

方式2：子类化LoginView后配置（适合需要扩展视图逻辑的场景） #

如果你除了换表单，还要给登录视图加额外逻辑（比如传递额外模板上下文、加登录前后的钩子处理），可以先继承LoginView写自己的登录视图类，在类里指定表单：

# 你的视图文件 views.py
from django.contrib.auth.views import LoginView
from .forms import CustomAuthenticationForm

class CustomLoginView(LoginView):
    # 在这里指定自定义表单
    authentication_form = CustomAuthenticationForm
    template_name = "account/login.html"
    redirect_authenticated_user = True

    # 自定义逻辑可以直接写在类里，比如扩展模板上下文
    def get_context_data(self, **kwargs):
        context = super().get_context_data(**kwargs)
        context["login_tip"] = "请使用公司分配的账号登录"
        return context

写完自定义视图后，去路由文件里把登录路由绑定到你写的视图类即可：

# urls.py
from django.urls import path
from .views import CustomLoginView

urlpatterns = [
    path("login/", CustomLoginView.as_view(), name="login"),
    # 其他路由...
]

验证是否生效 #

配置完成后访问登录页，检查：

• 表单渲染的字段、字段属性（比如placeholder、css类）是否和你在自定义表单里定义的一致
• 提交表单时，你在自定义表单里写的校验逻辑（比如额外的验证码校验、账号状态判断）是否正常触发

如果以上都符合预期，说明配置已经生效。

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