Django实现用户注册与邮箱激活验证完整流程

月亮慢半拍

发布时间：2026-10-13 | 2人浏览过

原创

本文详细解析如何在Django框架中构建用户注册系统，涵盖从RegisterView视图处理、RegisterForm表单验证到前端HTML模板的完整代码实现。重点介绍如何利用django-simple-captcha模块添加验证码，并通过自定义EmailVerifyRecord模型及send_register_email函数实现邮箱激活链接发送。最后展示ActiveUserView如何更新用户状态并集成至登录逻辑，确保只有激活用户可访问系统。

本文深入介绍了在Python编程环境下，利用Django模块构建用户注册功能及邮箱验证机制的具体实现方案与核心代码。

用户注册模块：

参照用户登录的逻辑，在users.views.py文件中新增RegisterView(View)类，专门负责处理表单的get和post请求。当接收到get请求时，系统重新渲染register页面，引导用户填写注册信息。

 def get(self, request):
  register_form = RegisterForm()
  return render(request, "register.html", {'register_form':register_form})

当method为POST时，执行用户注册的核心逻辑：

 def post(self, request):
  # 实例化form，验证每个字段是否合法
  register_form = RegisterForm(request.POST)
  pre_check = register_form.is_valid()
  if pre_check:
   # 取出email和password
   user_name = request.POST.get("email", "")
   pass_word = request.POST.get("password", "")
   # 实例化用户，然后赋值
   user_profile = UserProfile()
   user_profile.username = user_name
   user_profile.email = user_name
   # 新建用户为非活跃用户，可通过验证变为活跃用户
   user_profile.is_active = False
   # 将明文转换为密文赋给password
   user_profile.password = make_password(pass_word)
   user_profile.save() # 保存到数据库
   # 此处加入了邮箱验证的手段
   send_register_email(user_name, "register")
   return render(request, "login.html")
  else:
   # form表单验证失败，将错误信息传给前端
   return render(request, "register.html", {"register_form": register_form})

在form.py文件中定义RegisterForm类，用于封装和处理前端提交的表单数据：

class RegisterForm(forms.Form):
 # 不能为空
 email = forms.EmailField(required=True)
 password = forms.CharField(required=True, min_length=6， max_length=20)
 # 出错信息
 captcha = CaptchaField(error_messages={"invalid":u"验证码错误"})

以下是配套的前端HTML代码，其中运用了Django的模板语法，通过{% %}结构嵌入逻辑判断，避免了在HTML中直接插入Python代码，从而提升了代码的可维护性和修改便利性。

<form id="email_register_form" method="post" action="{% url 'register' %}" autocomplete="off">
      <div class="form-group marb20 {% if register_form.errors.email %}errorput{% endif %}">
       <label>邮&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;箱</label>
       <input type="text" id="id_email" name="email" value="{{ register_form.email.value }}" placeholder="请输入您的邮箱地址" />
      </div>
      <div class="form-group marb8 {% if register_form.errors.password %}errorput{% endif %}">
       <label>密&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;码</label>
       <input type="password" id="id_password" name="password" value="{{ register_form.password.value }}" placeholder="请输入6-20位非中文字符密码" />
      </div>
      <div class="form-group marb8 captcha1 {% if register_form.errors.captcha %}errorput{% endif %}">
       <label>验&nbsp;证&nbsp;码</label>
       {{ register_form.captcha }}
      </div>
      <div class="error btns" id="jsEmailTips">{% for key,error in register_form.errors.items %}{{ error }}{% endfor %} {{ msg }}</div>
      <div class="auto-box marb8">
      </div>
      <input class="btn btn-green" id="jsEmailRegBtn" type="submit" value="注册并登录" />
      {% csrf_token %}
     </form>

{% csrf_token %}标签是Django为防止跨站请求伪造攻击而提供的安全机制，若表单中未包含此标签，提交操作将无法成功执行。此外，表单中集成了一项验证码功能，在Django项目中可通过引入django-simple-captcha模块来实现：

在urls.py中配置url(r'^captcha/', include('captcha.urls'))以启用验证码路由。在前端模板中通过{{ register_form.captcha }}渲染验证码输入框。

邮箱验证模块：

在users.py中定义用于存储邮箱验证记录的Model模型：

class EmailVerifyRecord(models.Model):
 # 验证码
 code = models.CharField(max_length=20, verbose_name=u"验证码")
 email = models.EmailField(max_length=50, verbose_name=u"邮箱")
 # 包含注册验证和找回验证
 send_type = models.CharField(verbose_name=u"验证码类型", max_length=10, choices=(("register",u"注册"), ("forget",u"找回密码")))
 send_time = models.DateTimeField(verbose_name=u"发送时间", default=datetime.now)
 class Meta:
  verbose_name = u"邮箱验证码"
  verbose_name_plural = verbose_name
 def __unicode__(self):
  return '{0}({1})'.format(self.code, self.email)

在setting.py文件中配置邮件发送相关的服务器参数：

EMAIL_HOST = "smtp.163.com" # 服务器
EMAIL_PORT = 25    # 一般情况下都为25
EMAIL_HOST_USER = "abc@163.com" # 账号
EMAIL_HOST_PASSWORD = "password" # 密码
EMAIL_USE_TLS = False    # 一般都为False
EMAIL_FROM = "abc@163.com"  # 邮箱来自

创建utils目录，并新建email_send.py文件用于封装邮件发送逻辑。

from random import Random # 用于生成随机码 
from django.core.mail import send_mail # 发送邮件模块
from users.models import EmailVerifyRecord # 邮箱验证model
from MxOnline.settings import EMAIL_FROM # setting.py添加的的配置信息
# 生成随机字符串
def random_str(randomlength=8):
 str = ''
 chars = 'AaBbCcDdEeFfGgHhIiJjKkLlMmNnOoPpQqRrSsTtUuVvWwXxYyZz0123456789'
 length = len(chars) - 1
 random = Random()
 for i in range(randomlength):
  str+=chars[random.randint(0, length)]
 return str
def send_register_email(email, send_type="register"):
 email_record = EmailVerifyRecord()
 # 将给用户发的信息保存在数据库中
 code = random_str(16)
 email_record.code = code
 email_record.email = email
 email_record.send_type = send_type
 email_record.save()
 # 初始化为空
 email_title = ""
 email_body = ""
 # 如果为注册类型
 if send_type == "register":
  email_title = "注册激活链接"
  email_body = "请点击下面的链接激活你的账号:http://127.0.0.1:8000/active/{0}".format(code)
  # 发送邮件
  send_status = send_mail(email_title, email_body, EMAIL_FROM, [email])
  if send_status:
   pass

接下来实现将用户状态更新为活跃的逻辑，并在相关的View中处理激活请求：

class ActiveUserView(View):
 def get(self, request, active_code):
 # 用code在数据库中过滤处信息
  all_records = EmailVerifyRecord.objects.filter(code=active_code)
  if all_records:
   for record in all_records:
    email = record.email
    # 通过邮箱查找到对应的用户
    user = UserProfile.objects.get(email=email)
    # 激活用户
    user.is_active = True
    user.save()
      else:
   return render(request, "active_fail.html")
  return render(request, "login.html")

配置生成激活页面的URL路由：

url(r'^active/(?P<active_code>.*)/$', ActiveUserView.as_view(), name="user_active"), # 提取出active后的所有字符赋给active_code

最后，将is_active字段纳入登录验证的限制条件中：

    if user.is_active:
     login(request, user) # 调用login方法登陆账号
     return render(request, "index.html")
    else:
     return render(request, "login.html", {"msg": u"用户未激活"})

总结

以上内容完整展示了Python通过Django实现用户注册及邮箱验证功能的代码细节，希望能为读者提供实质性的帮助。感兴趣的技术人员可继续查阅本站其他相关专题。若内容存在疏漏，欢迎留言指正，感谢大家的支持！