Django自定义用户注册报错：Manager isn't available; auth.User已替换为stackapp.CustomUser

这个错误的核心原因是：替换默认auth.User为自定义模型后，代码中仍有直接引用原User模型或未使用正确用户管理器的地方，导致Django无法找到对应的模型管理器。

具体修复步骤： #

1. 确认settings.py配置正确
   确保已在项目配置中指定自定义用户模型：

AUTH_USER_MODEL = 'stackapp.CustomUser'

2. 修复forms.py中的注册表单
   如果使用了UserCreationForm，不能再绑定默认User模型，要改用get_user_model()获取当前活跃用户模型：

from django.contrib.auth.forms import UserCreationForm
from django.contrib.auth import get_user_model

class RegisterForm(UserCreationForm):
    class Meta:
        model = get_user_model()
        # 根据你的CustomUser字段调整要显示的字段
        fields = ['username', 'email', 'password1', 'password2']

3. 确保models.py中自定义用户模型配置正确
   自定义用户模型必须指定正确的管理器，尤其是继承AbstractBaseUser时（继承AbstractUser可使用默认管理器，但自定义字段建议显式指定）：

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

class CustomUserManager(BaseUserManager):
    def create_user(self, email, password=None, **extra_fields):
        if not email:
            raise ValueError('必须填写邮箱')
        email = self.normalize_email(email)
        user = self.model(email=email, **extra_fields)
        user.set_password(password)
        user.save(using=self._db)
        return user

    def create_superuser(self, email, password=None, **extra_fields):
        extra_fields.setdefault('is_staff', True)
        extra_fields.setdefault('is_superuser', True)
        return self.create_user(email, password, **extra_fields)

class CustomUser(AbstractUser):
    # 自定义字段示例
    phone = models.CharField(max_length=15, blank=True, verbose_name='手机号')
    # 绑定自定义管理器
    objects = CustomUserManager()

4. 修复views.py中的模型引用
   视图中不要直接导入auth.User，统一用get_user_model()：

from django.shortcuts import render, redirect
from django.contrib.auth import get_user_model
from .forms import RegisterForm

User = get_user_model()

def register(request):
    if request.method == 'POST':
        form = RegisterForm(request.POST)
        if form.is_valid():
            user = form.save()
            # 后续登录或跳转逻辑
            return redirect('home')
    else:
        form = RegisterForm()
    return render(request, 'accounts/register.html', {'form': form})

5. 重新执行数据库迁移
   如果是首次配置自定义用户模型，执行以下命令：

python manage.py makemigrations
python manage.py migrate

注意：如果是中途替换默认用户模型，Django不支持直接修改迁移，建议清空数据库后重新迁移，或使用第三方工具处理历史数据。

关键注意事项： #

• 项目中所有涉及用户模型的地方，都要用from django.contrib.auth import get_user_model获取模型，禁止直接引用django.contrib.auth.models.User
• 自定义用户模型必须在项目初始化时配置，中途修改会导致迁移问题
• 继承AbstractBaseUser时，必须手动实现用户管理器的create_user和create_superuser方法

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