如何修改Django默认双因素认证登录页面？模板失效求助

一、模板不生效的排查与解决 #

• 匹配模板路径结构：第三方双因素认证包（如django-two-factor-auth）的登录模板路径通常为two_factor/login.html，需在项目templates目录下创建完全一致的路径层级，将复制的模板放在项目根目录/templates/two_factor/login.html，确保文件名和路径与原模板完全匹配。
• 调整应用加载顺序：在settings.py的INSTALLED_APPS中，将包含自定义模板的主应用放在two_factor之前，让Django优先加载你的自定义模板。示例：

  INSTALLED_APPS = [
      'your_main_app',  # 你的应用前置
      'two_factor',
      # 其他应用...
  ]
  

• 清除模板缓存：开发环境下直接重启Django服务器；生产环境执行python manage.py clearcache命令清除缓存，避免旧模板被复用。
• 验证模板内容：在自定义模板中添加标识性注释（如<!-- 自定义模板 -->），刷新页面查看是否生效，排除文件复制错误的可能。

二、移除冗余按钮并调整跳转逻辑 #

1. 删除返回/下一步按钮 #

打开自定义的two_factor/login.html模板，定位并删除对应按钮代码：

• 找到类似<button type="submit" name="wizard_goto_step" value="previous">返回</button>的返回按钮代码，直接删除。
• 找到类似<button type="submit" class="btn btn-primary">下一步</button>的下一步按钮代码，删除该元素。
• 保留登录按钮代码，确保表单提交功能正常。

2. 实现登录后自动跳转令牌页 #

通过重写登录视图，让用户登录后（若开启双因素认证）直接跳转到令牌验证页面：

• 在应用中创建自定义视图：

  from django.shortcuts import redirect
  from two_factor.views import LoginView
  from two_factor.models import Device
  
  class CustomTwoFactorLoginView(LoginView):
      def form_valid(self, form):
          response = super().form_valid(form)
          user = self.request.user
          # 检查用户是否有已验证的双因素设备
          if Device.objects.filter(user=user, verified=True).exists():
              # 跳转到令牌验证页面
              return redirect('two_factor:login')
          return response
  

• 在项目urls.py中替换默认登录路由：

  from django.urls import path
  from .views import CustomTwoFactorLoginView
  import two_factor.views as tf_views
  
  urlpatterns = [
      # 替换为自定义登录视图
      path('accounts/login/', CustomTwoFactorLoginView.as_view(), name='login'),
      # 保留双因素认证核心路由
      path('accounts/two-factor/verify/', tf_views.TwoFactorLoginView.as_view(), name='two_factor_login'),
      # 其他路由...
  ]
  

配置完成后，用户登录时若已开启双因素认证，会自动跳转至令牌输入页面，且登录页仅保留登录按钮。

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