Django创建超级用户报错django.db.utils.OperationalError: no such table: MainApp_user

AI 小北

2026-9-27

错误原因

这个报错本质是数据库中没有生成你自定义的User模型对应的MainApp_user表，常见诱因如下：

你虽然删除了旧数据库，但没有清理原有迁移文件，旧迁移记录和新的自定义用户模型冲突，导致迁移未实际生效
自定义用户模型和管理器的代码存在缺陷，导致迁移执行失败，表根本没创建：
- 自定义用户管理器MyUserManager缺少create_superuser方法，Django创建超级用户必须依赖该方法
- 自定义User类只继承了AbstractBaseUser，没有继承PermissionsMixin，缺少超级用户所需的权限字段、is_staff、is_active等核心字段
- ImageField类型的avatar字段未指定必填的upload_to参数，会直接导致迁移报错终止
- REQUIRED_FIELDS错误包含了password字段，password和USERNAME_FIELD是Django默认必填项，不需要显式声明，重复声明会导致逻辑冲突
迁移操作执行不完整，比如只执行了makemigrations未执行migrate，或者仅执行了其他应用的迁移，未执行MainApp的迁移

解决步骤

清理旧迁移残留：进入MainApp目录下的migrations文件夹，删除除__init__.py之外的所有文件，如果其他应用存在关联旧用户模型的迁移，也一并清理
修正models.py中的代码缺陷：

from django.contrib.auth.models import BaseUserManager, AbstractBaseUser, PermissionsMixin
from django.db import models

class MyUserManager(BaseUserManager):
    def create_user(self, username, password=None, **extra_fields):
        if not username:
            raise ValueError("用户名字段不能为空")
        user = self.model(username=username, **extra_fields)
        user.set_password(password)
        user.save(using=self._db)
        return user

    # 补充create_superuser方法
    def create_superuser(self, username, password=None, **extra_fields):
        extra_fields.setdefault('is_staff', True)
        extra_fields.setdefault('is_superuser', True)
        extra_fields.setdefault('is_active', True)
        return self.create_user(username, password, **extra_fields)


class User(AbstractBaseUser, PermissionsMixin):
    username = models.CharField(max_length=30, unique=True)
    # password字段由AbstractBaseUser自带，不需要重复声明
    name = models.CharField(max_length=30, blank=True)
    surname = models.CharField(max_length=30, blank=True)  
    # 补充upload_to参数，增加blank、null避免创建超级用户时要求上传头像
    avatar = models.ImageField(upload_to="avatars/", width_field=512, height_field=512, blank=True, null=True)
    email_link = models.CharField(max_length=64, blank=True, null=True)
    bio = models.CharField(max_length=512, blank=True, null=True)
    registered = models.DateField(auto_now_add=True)
    # 补充超级用户所需的核心字段
    is_staff = models.BooleanField(default=False)
    is_active = models.BooleanField(default=True)

    USERNAME_FIELD = "username"
    # 移除password，不需要显式声明
    REQUIRED_FIELDS = []
    objects = MyUserManager()

    def __str__(self):
        return self.username

重新生成迁移文件，执行命令：python manage.py makemigrations，确认无报错提示
执行迁移应用到数据库，执行命令：python manage.py migrate，确认输出中存在Applying MainApp.0001_initial... OK的成功提示
重新执行创建超级用户命令：python manage.py createsuperuser即可正常操作

注意：项目接近收尾阶段更换自定义用户模型风险较高，你需要检查所有原有代码中关联了Django默认auth.User的地方，全部改为关联settings.AUTH_USER_MODEL，避免后续出现外键关联错误。

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