如何在Django中实现邮箱验证邮件发送功能？

我在Django项目中开发用户邮箱确认密钥发送功能，已经编写了views.py和models.py相关代码，但运行后既无报错也未发送邮件，请求协助排查问题。

相关代码 #

views.py #

def createuser(request):
    form = MyUserCreationForm()

    if request.method == 'POST':
        form = MyUserCreationForm(request.POST)
        if form.is_valid():
            return redirect('confirm-email')
        else:
            messages.error(request,'An error occured during your registration')
    context = {'form':form}
    return render(request, 'signup.html', context)

def confirmemail(request):
    form = MyUserCreationForm() 
    if request.method == 'POST':
        form = MyUserCreationForm(request.POST) 
        if form.is_valid():
            email = form.cleaned_data['email']
            user = User.objects.get(email=email)
            subject = 'Confirm your email' 
            from_email = 'myemail@gmail.com'
            email = [email]
            recipient_list = email
            return send_mail(subject, 'Use %s to confirm your email.' % request.user.confirmation_key, from_email, recipient_list)
        user.confirm_email(user.confirmation_key)
    
        
        if user.is_confirmed == True:
            user = form.save(commit=False)
            user.username = request.user.username.lower()
            user.save()
            login(request,user)
            return redirect('home')
    context = {'form':form}
    return render(request, 'emailconfirm.html', context)

models.py #

from django.db import models
from django.contrib.auth.models import AbstractUser
from simple_email_confirmation.models import SimpleEmailConfirmationUserMixin
class User(SimpleEmailConfirmationUserMixin, AbstractUser):
    name = models.CharField(max_length = 50)
    username = models.CharField(max_length = 50, null=True)
    email = models.EmailField(unique=True, null=True)

    USERNAME_FIELD = 'email'
    REQUIRED_FIELDS = ['name','username']
    

排查要点 #

1. 用户未被创建，导致后续查询失败 #

createuser视图中，当form.is_valid()通过后直接重定向到确认页面，没有保存用户实例。这会导致confirmemail视图里的User.objects.get(email=email)抛出User.DoesNotExist异常，若没有全局异常处理，可能只会静默失败。

修复方式：在createuser的form.is_valid()分支里先保存用户：

if form.is_valid():
    user = form.save(commit=False)
    user.username = user.username.lower()  # 统一用户名格式
    user.save()
    # 调用Mixin方法生成邮箱确认密钥
    user.add_email(user.email)
    return redirect('confirm-email')

2. confirmemail视图逻辑顺序错误，关键代码无法执行 #

• 当form.is_valid()通过后直接return send_mail(...)，导致后续邮箱确认、用户保存、登录代码完全不会执行。
• request.user此时是匿名用户（未登录），调用request.user.confirmation_key会抛出属性不存在错误，说明代码可能根本没走到这个分支（比如form.is_valid()未通过）。

修复方式：调整逻辑顺序，使用查询到的user对象而非request.user，并移除不必要的return：

if form.is_valid():
    email = form.cleaned_data['email']
    try:
        user = User.objects.get(email=email)
    except User.DoesNotExist:
        messages.error(request, "该邮箱未注册")
        return redirect('createuser')
    
    subject = 'Confirm your email' 
    from_email = 'myemail@gmail.com'
    # 使用查询到的user对象的确认密钥
    message = f'Use {user.confirmation_key} to confirm your email.'
    # 发送邮件不要直接return，保留后续执行逻辑
    send_mail(subject, message, from_email, [email])
    
    # 补充：当前逻辑缺少用户输入密钥的验证步骤，需添加对应表单接收密钥后再调用confirm_email
    # 示例：
    # key = form.cleaned_data.get('confirmation_key')
    # if user.confirm_email(key):
    #     user.is_confirmed = True
    #     user.save()
    #     login(request, user)
    #     return redirect('home')

3. Django邮件配置缺失 #

即使代码逻辑正确，未在settings.py中配置邮件参数，send_mail也不会发送邮件，且无明显报错。需添加类似配置（以Gmail为例）：

EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
EMAIL_HOST = 'smtp.gmail.com'
EMAIL_PORT = 587
EMAIL_USE_TLS = True
EMAIL_HOST_USER = 'your-email@gmail.com'
EMAIL_HOST_PASSWORD = 'your-app-password'  # Gmail需使用应用专用密码，而非登录密码

4. 自定义用户模型未正确配置 #

• 确保在settings.py中指定自定义用户模型：

AUTH_USER_MODEL = '你的应用名.User'

• 确认SimpleEmailConfirmationUserMixin已正确生成确认密钥，用户创建时可手动调用add_email方法确保密钥生成。

5. 表单验证失败无提示 #

confirmemail视图中，form.is_valid()未通过时无错误提示，导致误以为代码正常执行。需添加提示：

if form.is_valid():
    # ... 现有逻辑
else:
    messages.error(request, "表单填写有误，请检查")

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