如何在现有Django用户注册系统中添加社交登录与邮箱验证？

一、邮箱验证实现（无需修改默认User模型） #

默认Django User模型自带email字段，但缺少验证状态记录，我们用一对一关联扩展模型的方式，完全不影响现有用户数据：

1. 创建扩展Profile模型
   在你的app的models.py里添加：

from django.db import models
from django.contrib.auth.models import User
from django.db.models.signals import post_save
from django.dispatch import receiver
import uuid

class UserProfile(models.Model):
    user = models.OneToOneField(User, on_delete=models.CASCADE)
    email_verified = models.BooleanField(default=False)
    verification_token = models.UUIDField(default=uuid.uuid4, unique=True)

# 自动为现有及新用户创建Profile记录
@receiver(post_save, sender=User)
def create_user_profile(sender, instance, created, **kwargs):
    if created:
        UserProfile.objects.create(user=instance)
    else:
        # 为已有用户补建Profile（首次迁移后可注释）
        UserProfile.objects.get_or_create(user=instance)

2. 执行迁移
   运行命令：

python manage.py makemigrations
python manage.py migrate

这一步会自动为现有5位用户创建对应的UserProfile记录，不会丢失任何数据。

3. 修改注册表单与视图
   自定义注册表单，添加邮箱字段：

# forms.py
from django.contrib.auth.forms import UserCreationForm
from django.contrib.auth.models import User
from django import forms

class CustomUserCreationForm(UserCreationForm):
    email = forms.EmailField(required=True)

    class Meta:
        model = User
        fields = ('username', 'email', 'password1', 'password2')

修改views.py里的视图：

# views.py
from django.shortcuts import render
from django.views import generic
from django.urls import reverse_lazy
from django.core.mail import send_mail
from .forms import CustomUserCreationForm
from .models import UserProfile

class UserRegistrationView(generic.CreateView):
    form_class = CustomUserCreationForm
    template_name = 'registration/registration.html'
    success_url = reverse_lazy('login')

    def form_valid(self, form):
        response = super().form_valid(form)
        # 给新用户发送邮箱验证邮件
        user = self.object
        profile = user.userprofile
        verification_url = f"{self.request.scheme}://{self.request.get_host()}/verify-email/{profile.verification_token}/"
        send_mail(
            '验证你的邮箱',
            f'点击链接完成验证：{verification_url}',
            'your-email@example.com',
            [user.email],
            fail_silently=False,
        )
        return response

4. 添加邮箱验证视图
   在views.py新增：

from django.shortcuts import redirect, get_object_or_404
from django.contrib import messages
from .models import UserProfile

def verify_email(request, token):
    profile = get_object_or_404(UserProfile, verification_token=token)
    profile.email_verified = True
    profile.save()
    messages.success(request, '邮箱验证成功！')
    return redirect('login')

并在urls.py添加路由：

path('verify-email/<uuid:token>/', verify_email, name='verify_email'),

二、Facebook/Gmail社交登录实现（用django-allauth） #

django-allauth支持直接与默认Django User模型集成，完美兼容现有用户，无需修改用户表：

1. 安装依赖

pip install django-allauth

2. 配置settings.py
   添加如下配置：

INSTALLED_APPS = [
    # 原有apps
    'django.contrib.sites',
    'allauth',
    'allauth.account',
    'allauth.socialaccount',
    'allauth.socialaccount.providers.facebook',
    'allauth.socialaccount.providers.google',
]

AUTHENTICATION_BACKENDS = [
    'django.contrib.auth.backends.ModelBackend',
    'allauth.account.auth_backends.AuthenticationBackend',
]

SITE_ID = 1

# 可选配置，与自定义邮箱验证兼容
ACCOUNT_EMAIL_VERIFICATION = 'optional'
LOGIN_REDIRECT_URL = '/'

3. 配置urls.py
   在项目根urls.py添加：

path('accounts/', include('allauth.urls')),

4. 后台配置社交应用
   登录Django admin：

• 确认SITE_ID=1对应的站点域名正确
• 进入Social Applications，分别添加Facebook和Google的应用信息（需在对应平台创建开发者应用，获取Client ID和Secret）
• 将创建的社交应用关联到你的站点

5. 模板中添加社交登录按钮
   在登录/注册模板里添加：

{% load socialaccount %}
<a href="{% provider_login_url 'facebook' %}">用Facebook登录</a>
<a href="{% provider_login_url 'google' %}">用Gmail登录</a>

现有用户可直接通过社交账号绑定已有账号，不会丢失原有数据。

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