如何为Django allauth的用户名添加最大长度限制

Django allauth确实没有提供ACCOUNT_USERNAME_MAX_LENGTH这个配置项，但有几种简单的方式可以实现用户名最大长度限制，下面分两种常用方案说明，同时帮你修正代码里的问题：

方案1：自定义注册表单（无需修改View） #

这是最直接的方式，只需要在你的自定义注册表单中给username字段添加MaxLengthValidator，不需要自定义SignupView，利用allauth自带的ACCOUNT_SIGNUP_FORM_CLASS配置即可生效。

修正后的表单代码：

from django.core.validators import MaxLengthValidator
from allauth.account.forms import SignupForm
from django import forms
from captcha.fields import ReCaptchaField
from your_project_name.config import config  # 替换成你的config导入路径

class AllauthSignupForm(SignupForm):
    # 保留你的验证码字段
    captcha = ReCaptchaField(
        public_key=config("RECAPTCHA_PUBLIC_KEY"),
        private_key=config("RECAPTCHA_PRIVATE_KEY"),
    )

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 给username字段添加最大长度验证器
        self.fields['username'].validators.append(
            MaxLengthValidator(
                150,
                message="Username should be less than 150 characters long"
            )
        )
        # 可选：同时设置字段的max_length属性，让前端表单也能显示长度限制（比如HTML的maxlength属性）
        self.fields['username'].max_length = 150

    def signup(self, request, user):
        # 调用父类的signup方法，避免 deprecation warning
        super().signup(request, user)
        # 这里可以添加你的自定义逻辑，比如保存额外字段到用户模型

然后在settings.py中只需要保留这个配置（不需要自定义View和修改allauth的urls）：

ACCOUNT_SIGNUP_FORM_CLASS = 'draft1.forms.AllauthSignupForm'

方案2：使用自定义用户模型（数据库层面也限制） #

如果希望从数据库层面就限制用户名长度，同时让表单自动继承这个限制，可以自定义用户模型：

from django.contrib.auth.models import AbstractUser
from django.db import models

class CustomUser(AbstractUser):
    # 重写username字段，设置自定义max_length
    username = models.CharField(
        max_length=150,
        unique=True,
        help_text="Required. 150 characters or fewer. Letters, digits and @/./+/-/_ only.",
        validators=[AbstractUser.username.field.validators[0]],  # 保留原有的用户名格式验证器
    )

然后在settings.py中指定自定义用户模型：

AUTH_USER_MODEL = 'draft1.CustomUser'

这样allauth会自动使用这个模型的字段属性，表单的username字段会自动继承max_length=150的限制，不需要额外修改表单。

你之前代码的问题分析 #

1. 循环导入/配置冲突：你同时自定义了SignupView和设置ACCOUNT_SIGNUP_FORM_CLASS，这会导致allauth在初始化表单时出现冲突，其实只需要其中一种方式即可，推荐用ACCOUNT_SIGNUP_FORM_CLASS更简单。
2. 验证器添加方式错误：你写的self.fields['username']['validators'] += ...是错误的，因为self.fields['username']是一个字段对象，不是字典，应该用属性访问self.fields['username'].validators.append(...)。
3. 不必要的Meta类：你的表单继承自SignupForm，不需要添加Meta类指定model = User，因为SignupForm已经关联了用户模型。

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