Django查询voter模型报1054未知列utility_voter.Id错误排查

在Django项目视图函数中查询voter模型数据时触发SQL报错：

SQL Error (1054, "Unknown column 'utility_voter.Id' in 'field list'")

已先后执行python3 manage.py makemigrations utility、python3 manage.py migrate命令完成utility应用的数据库迁移操作，报错仍未消除。

• 核心原因是模型定义与数据库实际表结构不匹配：
  首次生成voter模型迁移文件时，若主键字段Id未放在类字段定义的最靠前位置，或首次迁移时未声明Id为主键，Django会按默认规则生成名为id（小写）的主键列；后续手动添加大写Id作为主键时，若迁移文件未正确识别字段变更，实际数据库表中不会生成大写Id列，但ORM查询时会按当前模型声明的主键名Id拼接SQL，最终触发列不存在报错。
• 迁移未实际生效：执行迁移命令时存在未解决的模型冲突，虽然终端返回迁移成功提示，但表结构未同步更新。
• 现有模型存在多处显性定义问题，会引发后续其他报错：
  • 常量拼写错误：Reqired_FIELDS拼写错误，Django自定义用户模型对应的必填字段常量为REQUIRED_FIELDS；且该常量列表中引用的constituency_id字段未在voter模型中声明，触发用户校验逻辑时会直接报错。
  • 外键命名不规范：所有外键字段均带_id后缀，Django ORM会自动为外键字段追加_id作为数据库列名，最终会生成xxx_id_id格式的冗余列名。
  • 自定义用户模型配置缺失：booth_manager类继承了AbstractBaseUser但未配置配套的BaseUserManager，也未在settings.py中通过AUTH_USER_MODEL指定该模型为系统用户模型，无法正常作为用户表使用。

按以下步骤操作即可修复问题：

1. 调整voter模型字段定义顺序，将主键字段移到所有字段最靠前位置，修正拼写错误、移除不存在的字段引用，修正后基础代码如下：

class voter(models.Model):
    # 主键放在字段定义最前
    Id = models.AutoField(primary_key=True)
    voter_id = models.IntegerField(unique=True)
    aadhaar_no = models.CharField(unique=True,max_length=50)
    name = models.CharField(max_length=100)
    age = models.IntegerField()
    address = models.TextField(max_length=200)
    email = models.EmailField(max_length=50, blank=True)
    phone_no = PhoneNumberField(max_length=13,unique=True)
    # 修正常量拼写，移除不存在的constituency_id引用
    REQUIRED_FIELDS = ['name','phone_no','aadhaar_no']

2. 同步表结构，根据环境选择对应方案：
   • 开发环境（无重要存量数据）：
     直接删除项目中的数据库文件（默认是db.sqlite3，使用MySQL/PostgreSQL则手动删除utility应用对应的所有表），删除utility应用下migrations文件夹中除__init__.py外的所有文件，重新执行迁移命令：

     python3 manage.py makemigrations utility
     python3 manage.py migrate
     

   • 生产环境（有存量数据不可删除）：
     登录数据库手动修改utility_voter表结构：如果表中存在小写id主键列，将其重命名为Id；如果没有主键列则新增Id自增主键列，再新增voter_id整数类型唯一约束字段即可，无需全量删表重建。
3. （可选规范优化）
   • 将所有模型类名改为Django推荐的大驼峰格式，比如election_type改为ElectionType、voter改为Voter。
   • 所有外键字段去掉_id后缀，比如election_type_id改为election_type，避免ORM自动生成列名时出现_id_id的冗余命名。
   • 补全booth_manager作为自定义用户模型的必要配置，添加对应的用户管理器，在settings.py中指定AUTH_USER_MODEL = 'utility.booth_manager'。

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