未完成邮箱验证的用户重复注册时如何发送确认邮件并处理报错？

核心处理思路为调整邮箱唯一性校验的触发范围，不要把未完成验证的注册记录纳入校验范围，以下是两种可落地的实现方案：

方案1：拆分临时表存储未验证数据 #

该方案可以保证主用户表无垃圾数据，适合用户量较大的场景：

• 新增unverified_users临时表，存储未完成邮箱验证的注册信息，字段包含邮箱、密码哈希、验证令牌、过期时间，无需设置邮箱唯一约束
• 主用户表users仅存储已完成验证的用户，保留原有邮箱唯一约束
• 注册接口逻辑调整为：
  1. 收到注册请求时优先查询主users表，邮箱存在直接返回「邮箱已注册」报错
  2. 主表无匹配记录时，先删除unverified_users表中该邮箱的旧记录，写入新的注册信息后重新发送验证邮件
  3. 用户点击验证链接且令牌校验通过后，将对应数据从unverified_users迁移到主users表，同时删除临时表的对应记录
  4. 配置定时任务，定期清理unverified_users中超过24小时未验证的过期数据

方案2：单表加字段调整校验逻辑 #

该方案改动量更小，适合快速迭代的中小项目：

• 用户表新增is_verified布尔字段、verification_token字段、verification_expired_at字段，原有全局邮箱唯一约束可替换为条件唯一约束
• 注册接口逻辑调整为：
  1. 收到注册请求后先查询该邮箱对应的用户记录
  2. 记录存在且is_verified=True：直接返回「邮箱已注册」报错
  3. 记录存在且is_verified=False：直接覆盖原有记录的密码哈希、验证令牌、过期时间，重新发送验证邮件，不触发报错
  4. 无对应记录：正常写入未验证用户记录，发送验证邮件
• 不同数据库的条件唯一约束实现示例：
  • PostgreSQL可直接创建部分唯一索引：

    CREATE UNIQUE INDEX unique_verified_email ON users (email) WHERE is_verified = true;
    

  • MySQL可通过虚拟列配合唯一索引实现，也可直接在ORM层自定义校验逻辑，排除未验证用户的校验
• 若使用Django REST Framework开发接口，可自定义邮箱唯一性校验器实现逻辑：

  from rest_framework.validators import UniqueValidator
  
  class UniqueVerifiedEmailValidator(UniqueValidator):
      def filter_queryset(self, value, queryset):
          return queryset.filter(is_verified=True, email=value)
  

体验优化建议 #

• 给验证邮件发送操作加频率限制，同一邮箱1分钟内最多触发1次发送，避免接口被滥用
• 重复注册未验证邮箱时，给前端返回*「验证邮件已重新发送，请查收」*的提示，而非报错，提升用户体验
• 验证令牌设置合理的过期时间，建议24小时内有效，避免未验证账号长期占用邮箱名额

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