如何在用户更新表单中使用django-allauth的用户名验证方法

你手写校验逻辑的问题完全可以避免，allauth已经对外暴露了统一的用户名校验入口，你之前的调用方式存在错误才无法生效。

正确调用方式 #

不要直接引用DefaultAccountAdapter类调用未绑定方法，使用allauth提供的get_adapter()方法获取当前项目生效的账户适配器实例，直接调用实例的clean_username方法即可，所有在配置文件中定义的用户名规则会自动全部生效，不需要重复编写任何校验代码。

表单中正确的clean_username实现如下：

from allauth.account.adapter import get_adapter

def clean_username(self):
    username = self.cleaned_data.get("username")
    if username:
        # 这一行会自动完成所有内置校验
        username = get_adapter().clean_username(username)
    return username

该方法内置覆盖的校验规则 #

调用上述方法会自动执行所有allauth默认的用户名约束校验，包括但不限于：

• 根据ACCOUNT_PRESERVE_USERNAME_CASING配置自动处理用户名大小写
• 校验ACCOUNT_USERNAME_MIN_LENGTH、ACCOUNT_USERNAME_MAX_LENGTH配置的长度规则
• 校验ACCOUNT_USERNAME_BLACKLIST黑名单、ACCOUNT_USERNAME_RESERVED保留用户名规则
• 校验用户名符合允许的字符格式要求
• 校验用户名未被其他用户占用（编辑当前用户信息时会自动排除自身，不会误判同名报错）
• 校验不通过时自动抛出对应文案的ValidationError，和注册、登录流程的错误提示完全一致

注意事项 #

• 禁止直接实例化DefaultAccountAdapter，必须使用get_adapter()获取适配器实例，否则如果你后续自定义了适配器重写用户名校验逻辑，这里的调用不会同步生效
• 该方法不限制使用场景，除了表单清洗逻辑，在视图、序列化器等任意需要校验用户名的位置都可以直接调用

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