Django allauth：如何重写邮箱确认URL及前端验证方案

我来帮你梳理下这个问题的解决思路，分两种场景给你具体方案：

一、自定义邮件中的确认URL链接 #

首先得说清楚{{ activate_url }}的来源：它是rest-auth依赖的django-allauth自动生成的，里面包含了用户ID的编码值和验证token，指向后端的邮箱确认页面。要改成你想要的前端链接，核心是拿到验证所需的用户ID（uid）和验证密钥（token），然后把自定义URL传到邮件模板里。

具体可以按以下步骤操作：

1. 通过信号传递自定义上下文到邮件模板 #

django-allauth在发送确认邮件时会触发email_confirmation_sent信号，我们可以监听这个信号，把uid和token作为额外变量注入到邮件模板的上下文里：

• 在你的Django应用下创建signals.py文件，写入这段代码：

from allauth.account.signals import email_confirmation_sent
from django.dispatch import receiver

@receiver(email_confirmation_sent)
def add_custom_context_to_confirmation_email(sender, request, emailconfirmation, **kwargs):
    # 提取用户ID和验证密钥
    user_id = emailconfirmation.user.pk
    verify_token = emailconfirmation.key
    # 构造前端确认URL
    front_end_confirm_url = f"http://localhost:8080/confirm_email/{user_id}/{verify_token}"
    # 将自定义变量加入邮件模板上下文
    emailconfirmation.send(request, context={
        "user": emailconfirmation.user,
        "front_end_confirm_url": front_end_confirm_url,
        "uid": user_id,
        "token": verify_token
    })

• 接着在应用的apps.py里注册这个信号，确保Django启动时能加载它：

from django.apps import AppConfig

class YourAppConfig(AppConfig):
    default_auto_field = 'django.db.models.BigAutoField'
    name = 'your_app_name'

    def ready(self):
        import your_app_name.signals

• 最后修改templates/account/email/email_confirmation_message.txt模板，把原来的内容替换成：

要确认此信息正确，请访问{{ front_end_confirm_url }}

或者直接写死URL结构（更直观）：

要确认此信息正确，请访问http://localhost:8080/confirm_email/{{ uid }}/{{ token }}

2. 前端调用后端验证端点 #

用户点击前端链接后，你需要在前端页面解析URL里的uid和token，然后发送POST请求到后端完成验证。你可以用rest-auth自带的/rest-auth/registration/verify-email/端点（需要传key参数，也就是我们的token），或者自己写一个更友好的自定义端点：

比如自定义端点的代码（放在views.py里）：

from rest_framework.views import APIView
from rest_framework.response import Response
from rest_framework import status
from allauth.account.models import EmailConfirmation
from django.contrib.auth import get_user_model

User = get_user_model()

class CustomEmailVerifyView(APIView):
    def post(self, request):
        uid = request.data.get("uid")
        token = request.data.get("token")
        try:
            user = User.objects.get(pk=uid)
            email_confirm = EmailConfirmation.objects.get(user=user, key=token)
            # 执行邮箱确认逻辑
            email_confirm.confirm(request)
            return Response({"msg": "邮箱验证成功"}, status=status.HTTP_200_OK)
        except (User.DoesNotExist, EmailConfirmation.DoesNotExist):
            return Response({"error": "无效的验证链接"}, status=status.HTTP_400_BAD_REQUEST)

然后在urls.py里注册这个端点：

path("api/custom-verify-email/", CustomEmailVerifyView.as_view(), name="custom_verify_email")

前端就可以通过POST请求这个端点，带上uid和token参数完成验证流程。

二、前端验证邮箱的简便方法 #

如果觉得上面的步骤太繁琐，有个超省心的方案：不用修改邮件URL，而是让后端验证成功后直接跳转到前端的指定页面。

只需要在Django的settings.py里添加这两行配置：

# 匿名用户（未登录的新用户）验证成功后的跳转URL
ACCOUNT_EMAIL_CONFIRMATION_ANONYMOUS_REDIRECT_URL = "http://localhost:8080/email-confirm-success"
# 已登录用户验证成功后的跳转URL
ACCOUNT_EMAIL_CONFIRMATION_AUTHENTICATED_REDIRECT_URL = "http://localhost:8080/email-confirm-success"

这样用户点击原来的{{ activate_url }}链接后，后端完成验证会自动跳转到你指定的前端成功页面，前端只需要做一个简单的验证成功提示即可，完全不需要额外写请求逻辑，非常适合快速实现。

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