Django自定义用户模型报错：'CustomUser'对象不可调用 求助

这个错误核心原因是代码中将CustomUser的实例当成类来调用，或者变量名冲突覆盖了CustomUser类名，以下是针对性排查和修复步骤：

1. 检查forms.py（最常见出错点） #

注册表单的Meta类中，model参数必须指向CustomUser类，不能加括号实例化：
错误写法：

class CustomUserCreationForm(UserCreationForm):
    class Meta:
        model = CustomUser()  # 错误：实例化了类，导致后续调用时触发错误
        fields = ('email', 'username',)

正确写法：

class CustomUserCreationForm(UserCreationForm):
    class Meta:
        model = CustomUser  # 直接引用类，不要加括号
        fields = ('email', 'username',)

2. 检查views.py #

注册视图中创建用户时，避免错误调用CustomUser实例，同时检查是否有变量名覆盖类名：
错误写法1：用实例化方式创建用户

def register(request):
    if request.method == 'POST':
        form = CustomUserCreationForm(request.POST)
        if form.is_valid():
            user = CustomUser()  # 错误：应该用表单save或管理器方法创建
            user.save()

正确写法1：利用表单的save方法

def register(request):
    if request.method == 'POST':
        form = CustomUserCreationForm(request.POST)
        if form.is_valid():
            user = form.save()  # 通过表单创建用户实例

错误写法2：变量名覆盖CustomUser类

def register(request):
    CustomUser = CustomUser.objects.get(pk=1)  # 错误：变量名和类名重名，后续调用CustomUser()会触发错误

3. 检查managers.py #

确保自定义管理器中使用self.model（指向CustomUser类）而非实例化：
正确写法：

class CustomUserManager(BaseUserManager):
    def create_user(self, email, username, password=None, **extra_fields):
        email = self.normalize_email(email)
        user = self.model(email=email, username=username, **extra_fields)  # self.model是类，不是实例
        user.set_password(password)
        user.save(using=self._db)
        return user

4. 检查models.py #

确认CustomUser类定义中没有错误调用自身实例的情况：

class CustomUser(AbstractBaseUser, PermissionsMixin):
    # 字段定义...
    objects = CustomUserManager()

    # 错误示例：方法内错误实例化自身
    # def wrong_method(self):
    #     user = CustomUser()  # 这种写法会导致类被覆盖或错误调用

5. 清理缓存与迁移 #

若以上检查无误，执行以下命令清理可能的缓存或旧迁移问题：

python manage.py makemigrations
python manage.py migrate
rm -rf __pycache__/  # 手动删除项目中的缓存文件夹

内容的提问来源于stack exchange，提问作者Shravan K Subrahmanya