基于邮箱为用户名的Django自定义认证：学生注册匹配方案咨询

这是个很典型的校园类系统需求——管理员先录入学生的核心身份信息，学生自行注册时必须匹配这些信息才能完成账号创建并补充个人资料。下面是一套基于Django认证系统的完整实现思路：

1. 调整Student模型，关联Django用户模型 #

首先需要把你的Student模型和Django内置的用户模型关联起来，这样每个学生账号对应唯一的系统用户。修改后的模型如下：

from django.conf import settings
from django.db import models
from django.core.validators import RegexValidator

class Student(models.Model):
    name = models.CharField(max_length=50)
    surname = models.CharField(max_length=50)
    student_ID = models.CharField(
        unique=True, 
        max_length=14, 
        validators=[RegexValidator(regex='^.{14}$', message='The ID needs to be 14 characters long.')]
    )
    # 允许初始为空，学生注册后再填充
    photo = models.ImageField(upload_to='students_images', blank=True, null=True)
    email = models.EmailField(blank=True, null=True)
    phone = models.CharField(max_length=15, blank=True, null=True)
    # 关联Django用户，初始为null（管理员录入时未创建账号）
    user = models.OneToOneField(settings.AUTH_USER_MODEL, on_delete=models.CASCADE, null=True, blank=True)

    def __str__(self):
        return f"{self.name} {self.surname}"

2. 自定义注册表单，添加身份验证逻辑 #

我们需要扩展Django的UserCreationForm，加入学生身份字段的验证，确保输入的name/surname/student_ID匹配管理员预先录入的、且未注册过账号的学生记录：

from django import forms
from django.contrib.auth.forms import UserCreationForm
from django.contrib.auth import get_user_model
from .models import Student

class StudentRegistrationForm(UserCreationForm):
    # 加入需要验证的学生身份字段
    name = forms.CharField(max_length=50)
    surname = forms.CharField(max_length=50)
    student_ID = forms.CharField(max_length=14)
    # 学生需要填写的补充字段
    email = forms.EmailField()
    phone = forms.CharField(max_length=15)
    photo = forms.ImageField()

    class Meta:
        model = get_user_model()
        # 可以把username设为student_ID，避免重复输入，后面会自动赋值
        fields = ('username', 'password1', 'password2', 'name', 'surname', 'student_ID', 'email', 'phone', 'photo')

    def clean(self):
        cleaned_data = super().clean()
        name = cleaned_data.get('name')
        surname = cleaned_data.get('surname')
        student_id = cleaned_data.get('student_ID')

        # 验证核心逻辑：检查是否存在匹配的未注册学生
        try:
            # 这里用user__isnull=True确保同一个学生不能重复注册
            self.student = Student.objects.get(
                name=name, 
                surname=surname, 
                student_ID=student_id, 
                user__isnull=True
            )
        except Student.DoesNotExist:
            raise forms.ValidationError(
                "The provided student information does not match our records, or this student already has an account."
            )
        
        # 可选：强制用student_ID作为用户名，避免用户自行输入
        cleaned_data['username'] = student_id
        return cleaned_data

3. 自定义注册视图，处理表单提交与数据关联 #

接下来写一个视图函数，处理表单提交后的逻辑：创建用户、更新学生资料、关联两者并自动登录：

from django.shortcuts import render, redirect
from django.contrib.auth import login
from .forms import StudentRegistrationForm

def student_register(request):
    if request.method == 'POST':
        # 注意要接收request.FILES处理图片上传
        form = StudentRegistrationForm(request.POST, request.FILES)
        if form.is_valid():
            # 创建系统用户
            user = form.save()
            # 获取表单验证时找到的Student对象，更新字段
            student = form.student
            student.email = form.cleaned_data['email']
            student.phone = form.cleaned_data['phone']
            student.photo = form.cleaned_data['photo']
            student.user = user
            student.save()
            # 注册成功后自动登录
            login(request, user)
            return redirect('home')  # 替换成你的首页URL名称
    else:
        form = StudentRegistrationForm()
    
    return render(request, 'registration/student_register.html', {'form': form})

4. 编写注册模板 #

创建一个简单的模板registration/student_register.html来渲染表单：

{% extends 'base.html' %}

{% block content %}
<h2>Student Registration</h2>
<form method="post" enctype="multipart/form-data">
    {% csrf_token %}
    {{ form.as_p }}
    <button type="submit">Complete Registration</button>
</form>
{% endblock %}

额外注意事项 #

• 媒体文件配置：确保在settings.py中配置了MEDIA_ROOT和MEDIA_URL，否则图片无法正常上传和访问：

  MEDIA_ROOT = BASE_DIR / 'media'
  MEDIA_URL = '/media/'
  

  还要在根URL配置中添加媒体文件的路由：

  from django.conf import settings
  from django.conf.urls.static import static
  
  urlpatterns = [
      # 你的其他路由
  ] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
  

• 管理员表单优化：在管理员后台的Student表单中，可以把user字段设为只读，避免误操作：

  from django.contrib import admin
  from .models import Student
  
  class StudentAdmin(admin.ModelAdmin):
      readonly_fields = ('user',)
      # 其他配置...
  
  admin.site.register(Student, StudentAdmin)
  

这样一套流程下来，就能完美实现你想要的功能：管理员预先录入学生身份信息，学生注册时必须匹配这些信息才能创建账号，同时补充自己的联系方式和照片。

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