如何搭配自定义HTML表单模板使用Django内置身份认证功能

你可以通过两种路径实现需求，两种方案都完全支持沿用你已开发完成的HTML自定义表单模板：

路径1：优先方案 - 自定义用户模型对接内置认证（适用于可调整表结构的场景） #

如果你的自定义用户表还未上线、结构可调整，优先用Django原生扩展方式对接，后续维护成本最低：

• 第一步：定义继承AbstractUser的自定义用户模型，对齐你现有表的字段

# your_app/models.py
from django.contrib.auth.models import AbstractUser
from django.db import models

class CustomUser(AbstractUser):
    # 在这里添加你原有自定义表里的额外字段，比如手机号、昵称等
    phone = models.CharField(max_length=11, unique=True, verbose_name="手机号")
    # AbstractUser默认已包含username、email、password、is_active等通用字段，和你原有表重名的无需重复定义

• 第二步：配置settings指定全局用户模型

# settings.py
AUTH_USER_MODEL = "your_app.CustomUser"

• 第三步：迁移数据，如果你之前已经有存量用户数据，写迁移脚本导入到新的CustomUser表即可，密码如果不是Django默认哈希加密，先做一次加密转换。
• 第四步：直接沿用你已写好的HTML表单，视图层调用内置认证方法校验即可：

# your_app/views.py
from django.contrib.auth import authenticate, login
from django.shortcuts import render, redirect

def custom_login(request):
    if request.method == "POST":
        # 这里取的字段名对应你HTML表单中input的name属性，完全适配你自己写的表单结构
        username = request.POST.get("username")
        password = request.POST.get("password")
        # 内置方法自动对接你定义的CustomUser表做身份校验
        user = authenticate(request, username=username, password=password)
        if user is not None:
            login(request, user)
            # 登录成功跳转业务页
            return redirect("home_page")
        else:
            return render(request, "your_custom_login_template.html", {"err_msg": "账号或密码错误"})
    # GET请求直接渲染你自己开发的HTML模板即可，不需要用Django表单组件生成表单
    return render(request, "your_custom_login_template.html")

注意：你的HTML表单不需要做任何修改，只需要保证提交方式为POST、input的name属性和视图中取的字段名对应即可。

路径2：兼容方案 - 自定义认证后端（适用于表结构已固定无法修改的场景） #

如果你的自定义用户表已经上线、结构不能调整，就自定义认证后端直接对接原有表：

• 第一步：实现自定义认证后端逻辑

# your_app/auth_backend.py
from django.contrib.auth.backends import BaseBackend
from django.contrib.auth.hashers import check_password
from .models import YourOriginalUser # 导入你已有的自定义用户表模型

class CustomAuthBackend(BaseBackend):
    def authenticate(self, request, username=None, password=None, **kwargs):
        try:
            # 按你原有表的查询逻辑查用户，支持按手机号、邮箱等任意字段查询
            user = YourOriginalUser.objects.get(username=username)
            # 校验密码，如果你原有密码加密方式不是Django默认的，修改此处校验逻辑即可
            if check_password(password, user.password):
                return user
            return None
        except YourOriginalUser.DoesNotExist:
            return None

    def get_user(self, user_id):
        try:
            return YourOriginalUser.objects.get(pk=user_id)
        except YourOriginalUser.DoesNotExist:
            return None

• 第二步：配置settings注册自定义认证后端

# settings.py
AUTHENTICATION_BACKENDS = [
    "your_app.auth_backend.CustomAuthBackend",
    # 如果需要保留Django默认admin后台的用户认证能力，就加上默认后端
    "django.contrib.auth.backends.ModelBackend",
]

• 第三步：视图层用法和路径1完全一致，authenticate方法会自动调用你自定义的认证后端做校验，HTML表单无需任何修改。

注册功能适配方案 #

如果要沿用你自己开发的注册表单，视图层拿到表单数据后，调用make_password方法加密密码再存库即可：

from django.contrib.auth.hashers import make_password

def custom_register(request):
    if request.method == "POST":
        username = request.POST.get("username")
        password = request.POST.get("password")
        # 其他字段按你表单的name属性取值
        # 存入用户表，用你自己的模型即可
        CustomUser.objects.create(
            username=username,
            password=make_password(password), # 自动按Django规则加密密码
            # 其他字段赋值
        )
        return redirect("login_page")
    return render(request, "your_custom_register_template.html")

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