如何使用Django Allauth API停用、删除用户并释放邮箱地址

前置逻辑说明 #

Allauth 的邮箱唯一性校验默认优先读取account_emailaddress表的已验证邮箱记录，auth_user表的邮箱字段仅为冗余同步字段，仅修改auth_user表字段或is_active状态不会自动释放邮箱占用。

a) 停用用户（保留用户记录场景） #

需求1：仅禁止用户登录，不释放原邮箱 #

直接修改用户状态即可：

user.is_active = False
user.save()

无需其他额外操作。

需求2：禁止用户登录，同时允许原邮箱重新注册 #

需执行两步操作：

1. 删除 Allauth 邮箱表对应记录
   EmailAddress 需从allauth.account.models导入，执行：

   # 删除该用户所有关联的邮箱记录
   EmailAddress.objects.filter(user=user).delete()
   # 若仅需释放特定邮箱，可补充email过滤条件
   # EmailAddress.objects.filter(user=user, email="xxx@xx.com").delete()
   

   若没有自定义业务逻辑关联account_emailaddress表，直接手动删除该表对应条目是安全的，更推荐使用ORM操作避免遗漏内置逻辑触发。
2. 标记用户为未激活，执行上述is_active=False并保存的操作即可。

b) 彻底删除用户 #

直接调用Django原生的用户删除方法即可：

user.delete()

Allauth 默认对account_emailaddress、SocialAccount等关联表配置了外键级联删除逻辑，用户删除后所有关联的Allauth记录会自动清空，无需额外操作。

补充说明 #

Allauth 没有内置监听auth_user表is_active字段变更的信号，因为is_active=False的原生设计是禁用用户登录权限，并非释放用户身份标识，所以需要释放邮箱时必须主动删除account_emailaddress表的对应记录。

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