重命名Django模型主键字段触发ProgrammingError，求解决方案

• 确认外键关联影响：报错核心原因是其他表的外键仍在引用旧主键列名，Django自动生成的迁移仅处理了当前表的字段重命名，未同步更新外键的关联指向，导致数据库执行迁移时出现列不存在的错误。
• 检查迁移逻辑缺陷：migrations.RenameField操作仅修改当前表的字段名，但主键字段关联的外键约束不会自动更新，Django也不会自动生成外键约束的修改迁移。
• 验证数据库状态：查看数据库中my_app_mymodel表的实际字段，确认old_name列是否存在，是否有未完成的迁移导致状态不一致。

针对有外键关联的主键重命名场景，需分步骤调整迁移逻辑，具体操作如下：

步骤1：回滚未完成的迁移 #

若迁移已执行失败，先回滚到上一个正常的迁移版本：

python manage.py migrate my_app 0007_previous_migration

步骤2：修改模型代码，保留旧字段并添加新字段 #

不要直接重命名主键，先添加新的主键字段，同时将旧字段改为普通唯一字段：

from django.db import models as django_db_models

class MyModel(django_db_models.Model):
    old_name = django_db_models.BigAutoField(
                   null=False,
                   unique=True,  # 移除primary_key=True
                   auto_created=True,
               )
    new_name = django_db_models.BigAutoField(
                   null=False,
                   primary_key=True,
                   auto_created=True,
                   unique=True,
               )

步骤3：生成并执行迁移（同步新字段） #

生成迁移文件并执行，完成新主键字段的添加：

python manage.py makemigrations
python manage.py migrate

步骤4：更新所有关联的外键字段 #

找到所有关联MyModel的外键模型，修改外键的to_field参数指向新主键：

# 关联模型示例
class RelatedModel(django_db_models.Model):
    my_model = django_db_models.ForeignKey(
        MyModel,
        on_delete=django_db_models.CASCADE,
        to_field='new_name',  # 指定关联新主键字段
        related_name='related_models'
    )

生成并执行外键更新的迁移：

python manage.py makemigrations
python manage.py migrate

步骤5：删除旧的主键字段 #

确认所有外键都已关联到新主键后，删除模型中的old_name字段：

from django.db import models as django_db_models

class MyModel(django_db_models.Model):
    new_name = django_db_models.BigAutoField(
                   null=False,
                   primary_key=True,
                   auto_created=True,
                   unique=True,
               )

生成并执行删除字段的迁移：

python manage.py makemigrations
python manage.py migrate

备选方案：手动修改迁移文件（适合熟悉数据库操作的场景） #

若不想分多次迁移，可直接修改自动生成的迁移文件，添加外键约束的删除与重建逻辑：

from django.db import migrations

class Migration(migrations.Migration):
    dependencies = [
        ('my_app', '0007_previous_migration'),
    ]

    operations = [
        # 先删除关联MyModel的外键约束（替换为实际表名和约束名）
        migrations.RunSQL("ALTER TABLE my_app_relatedmodel DROP CONSTRAINT my_app_relatedmodel_my_model_id_fkey;"),
        # 重命名主键字段
        migrations.RenameField(
            model_name='mymodel',
            old_name='old_name',
            new_name='new_name',
        ),
        # 重建外键约束，指向新主键字段
        migrations.RunSQL("ALTER TABLE my_app_relatedmodel ADD CONSTRAINT my_app_relatedmodel_my_model_id_fkey FOREIGN KEY (my_model_id) REFERENCES my_app_mymodel(new_name);"),
    ]

注意：需替换SQL中的表名、约束名为数据库实际名称，可通过数据库客户端（如psql、mysql命令行）查看。

• 主键字段重命名涉及数据库核心约束，操作前务必备份数据库。
• 针对数据量较大的表，分步骤迁移时需注意数据一致性，避免数据丢失。
• Django 3.2.6版本对主键重命名的自动迁移支持有限，手动调整迁移是更可靠的方式。

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