无需删除现有表修复Django报错：Unknown column 'userdata.password'

问题描述 #

我的AWS RDS MySQL数据库内有一张名为userdata的表，该表在之前的迁移操作中曾使用users作为表名。如今使用新表名访问数据时，触发报错：1054, "Unknown column 'userdata.password' in 'field list'"。已有Stack Overflow帖子建议删除表后重建来解决问题，但我想了解是否存在无需删除现有表的修复方法？以下是指定了表名为userdata的CustomUser模型代码：

import uuid
from django.contrib.auth.models import AbstractBaseUser, PermissionsMixin
from django.db import models
from django.utils import timezone
from django.utils.translation import gettext_lazy as _

from .managers import CustomUserManager


class CustomUser(AbstractBaseUser, PermissionsMixin):
    id = models.UUIDField(primary_key=True, default=uuid.uuid4, editable=False)
    email = models.EmailField(_("邮箱地址"), unique=True)
    is_premium = models.BooleanField(default=False)
    is_active = models.BooleanField(default=True)
    date_joined = models.DateTimeField(default=timezone.now)
    plan_signup_date = models.DateTimeField(null=True, blank=True)
    
    first_name = models.CharField(max_length=30)
    last_name = models.CharField(max_length=30)
    is_admin = models.BooleanField(default=False)
    is_staff = models.BooleanField(default=False)
    is_superuser = models.BooleanField(default=False)

    ## 默认包含字段：id, password, last_login, is_superuser, groups, user_permissions

    USERNAME_FIELD = "email"
    REQUIRED_FIELDS = []

    objects = CustomUserManager()

    class Meta:
        db_table = "userdata"

    def __str__(self):
        return self.email

1. 先确认数据库表的实际结构 #

登录AWS RDS MySQL控制台或使用MySQL客户端，执行命令查看userdata表的字段：

DESCRIBE userdata;

如果看不到password、last_login这两个字段（这两个是AbstractBaseUser自带的必填字段），说明表结构与Django模型不匹配，这就是报错的核心原因。

2. 手动同步缺失的字段 #

若确实缺少字段，直接在MySQL中执行ALTER命令添加：

ALTER TABLE userdata 
ADD COLUMN password VARCHAR(128) NOT NULL,
ADD COLUMN last_login DATETIME NULL;

注意：password字段类型需与Django默认一致（VARCHAR(128)，因为Django存储的是哈希值），last_login允许为空。

3. 修复Django迁移历史（若迁移记录混乱） #

如果是重命名表后，Django迁移记录与实际数据库不一致导致后续迁移异常，可按以下步骤操作：

• 先备份数据库，避免操作失误
• 执行python manage.py makemigrations --empty 你的应用名生成空迁移文件
• 打开空迁移文件，在operations中添加SQL操作，示例：

from django.db import migrations, models

class Migration(migrations.Migration):
    dependencies = [
        ('你的应用名', '之前的迁移文件名'),
    ]

    operations = [
        migrations.RunSQL("ALTER TABLE userdata ADD COLUMN password VARCHAR(128) NOT NULL;"),
        migrations.RunSQL("ALTER TABLE userdata ADD COLUMN last_login DATETIME NULL;"),
    ]

• 执行python manage.py migrate应用迁移，让Django迁移记录与实际表结构同步

4. 用inspectdb验证模型与表的一致性 #

执行python manage.py inspectdb userdata > temp_model.py，生成基于现有数据库表的模型代码，对比当前的CustomUser模型，排查字段缺失或不匹配的问题，再调整模型或同步数据库表。

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