如何修复django-allauth强制邮箱验证场景下注册邮箱输入错误的死循环问题

这个坑我之前踩过！强制邮箱验证+输错邮箱确实会把用户卡死——登不上也改不了邮箱，给你几个从临时救急到长期根治的方案，按需选：

方法1：新增未登录状态下的邮箱修改入口（推荐长期用） #

既然用户登不上，那我们就做一个不用登录就能申请改邮箱的页面，通过用户名验证身份，给新邮箱发验证链接，确认后直接更新账户邮箱。

具体步骤： #

1. 在项目的urls.py里加两个新路由：

from django.urls import path
from . import views

urlpatterns = [
    # 保留原有allauth的路由
    path('accounts/request-email-change/', views.request_email_change, name='request_email_change'),
    path('accounts/confirm-email-change/<str:token>/', views.confirm_email_change, name='confirm_email_change'),
]

2. 在views.py写两个视图函数：

from django.shortcuts import render, redirect
from django.contrib.auth.models import User
from django.contrib import messages
from allauth.account.models import EmailAddress
from django.core.mail import send_mail
from django.conf import settings
import uuid

def request_email_change(request):
    if request.method == 'POST':
        username = request.POST.get('username')
        new_email = request.POST.get('new_email')
        try:
            user = User.objects.get(username=username)
            # 生成唯一验证token
            token = uuid.uuid4().hex
            # 临时存在session里（实际生产建议建个单独的模型存，避免session过期）
            request.session['ec_token'] = token
            request.session['ec_user_id'] = user.id
            request.session['ec_new_email'] = new_email
            
            # 发验证邮件到新邮箱
            verify_url = f"{settings.SITE_URL}/accounts/confirm-email-change/{token}/"
            send_mail(
                '[你的站点]确认修改邮箱',
                f'点击下方链接完成邮箱修改：\n{verify_url}\n链接24小时内有效',
                settings.DEFAULT_FROM_EMAIL,
                [new_email],
                fail_silently=False,
            )
            messages.success(request, '验证邮件已发送到新邮箱，请查收确认')
            return redirect('request_email_change')
        except User.DoesNotExist:
            messages.error(request, '找不到对应的用户名，请检查输入')
    return render(request, 'account/request_email_change.html')

def confirm_email_change(request, token):
    # 验证session里的token
    if request.session.get('ec_token') == token:
        user_id = request.session['ec_user_id']
        new_email = request.session['ec_new_email']
        user = User.objects.get(id=user_id)
        
        # 更新用户主邮箱
        user.email = new_email
        user.save()
        
        # 更新allauth的EmailAddress记录（标记为已验证、主邮箱）
        email_addr, _ = EmailAddress.objects.get_or_create(user=user, email=new_email)
        email_addr.verified = True
        email_addr.primary = True
        email_addr.save()
        
        # 清理session临时数据
        del request.session['ec_token']
        del request.session['ec_user_id']
        del request.session['ec_new_email']
        
        messages.success(request, '邮箱修改成功！现在可以正常登录了')
        return redirect('account_login')
    else:
        messages.error(request, '验证链接无效或已过期，请重新申请')
        return redirect('request_email_change')

3. 新建模板templates/account/request_email_change.html：

{% extends "base.html" %}
{% block content %}
<div class="container mt-4">
    <h2>修改注册邮箱</h2>
    {% if messages %}
        {% for msg in messages %}
            <div class="alert alert-{{ msg.tags }}">{{ msg }}</div>
        {% endfor %}
    {% endif %}
    <form method="POST" class="mt-3">
        {% csrf_token %}
        <div class="mb-3">
            <label for="username" class="form-label">你的用户名</label>
            <input type="text" class="form-control" id="username" name="username" required>
        </div>
        <div class="mb-3">
            <label for="new_email" class="form-label">新邮箱地址</label>
            <input type="email" class="form-control" id="new_email" name="new_email" required>
        </div>
        <button type="submit" class="btn btn-primary">发送验证邮件</button>
    </form>
</div>
{% endblock %}

方法2：临时放开登录限制（救急用） #

如果是个别用户出问题，不想改代码，可以临时调整settings.py的配置：

# 把强制验证改成可选
ACCOUNT_EMAIL_VERIFICATION = 'optional'

这样用户就能用用户名+密码登录，登录后去accounts/email页面修改邮箱，改完再把配置改回mandatory就行。

⚠️ 注意：这个方法会让未验证邮箱的用户也能登录，有一定安全风险，建议只临时用，或者配合中间件限制未验证用户只能访问邮箱修改页。

方法3：后台手动修改（最快处理单个用户） #

如果只是一两个用户遇到这个问题，直接登Django后台改最省事：

• 进入/admin/，找到Users，点开对应的用户，修改Email address字段
• 再找到EmailAddresses（allauth的模型），更新对应的邮箱记录，把Verified打勾，Primary设为True
• 通知用户可以登录了

预防措施：从源头减少输错邮箱的概率 #

可以自定义注册表单，让用户输入两次邮箱做验证：

from allauth.account.forms import SignupForm
from django import forms

class DoubleEmailSignupForm(SignupForm):
    confirm_email = forms.EmailField(label="确认邮箱")
    
    def clean(self):
        cleaned_data = super().clean()
        email = cleaned_data.get('email')
        confirm_email = cleaned_data.get('confirm_email')
        if email and confirm_email and email != confirm_email:
            raise forms.ValidationError("两次输入的邮箱不一致，请检查")
        return cleaned_data

然后在settings.py里配置这个表单：

ACCOUNT_SIGNUP_FORM_CLASS = 'your_app.forms.DoubleEmailSignupForm'

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