Django后台添加Employee报错：relation 'main_employee'不存在

以下是针对"relation 'main_employee' does not exist"错误的具体排查和解决步骤：

• 确认AUTH_USER_MODEL配置正确性
  打开项目的settings.py，检查是否正确指定了自定义用户模型：

  AUTH_USER_MODEL = 'main.Employee'
  

  这里的main是你的app名称，Employee是模型类名，必须和实际项目一致。如果配置错误，Django会继续使用默认的auth_user表，而你的迁移生成的是main_employee，就会出现表不存在的错误。

• 验证迁移是否真正生效

  1. 查看迁移文件：检查app下的migrations目录，确认存在针对Employee模型的迁移文件（比如0001_initial.py），文件中应包含创建main_employee表的SQL操作。
  2. 重新执行迁移：运行python manage.py migrate，观察控制台输出，确认是否有Applying main.XXXX... OK的提示。如果出现跳过、错误提示，说明迁移未成功执行。
  3. 直接核对数据库表：用数据库客户端连接数据库，执行对应命令查看表列表：
     • PostgreSQL：\dt
     • MySQL：show tables;
       如果找不到main_employee表，说明迁移未正确创建该表。

• 检查模型的db_table设置
  如果你的Employee模型中手动设置了db_table参数，比如：

  class Employee(AbstractUser):
      # 自定义字段
      class Meta:
          db_table = 'employee'
  

  此时数据库中的表名应为employee而非main_employee，admin查找main_employee自然会报错。解决方式：要么删除db_table配置，让Django自动生成表名；要么确保db_table的值与数据库实际表名完全一致。

• 清理冲突的迁移文件
  若存在旧迁移文件或迁移状态混乱，可按以下步骤重置迁移：

  1. 先备份数据库（避免数据丢失）
  2. 删除app下migrations目录中除__init__.py外的所有文件
  3. 删除数据库中django_migrations表内属于该app的所有记录
  4. 重新生成迁移：python manage.py makemigrations
  5. 执行迁移：python manage.py migrate

• 排查数据库表名大小写问题
  若使用Linux环境下的MySQL，默认表名区分大小写。如果模型Meta中的db_table使用了大写或驼峰命名，而Django生成的是小写表名，就会导致找不到表。确保db_table的名称与数据库实际表名完全一致（建议统一使用小写）。

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