Django中db_table无法重命名数据库表问题求助

问题背景 #

• 我们开发的organizations、authentication等Django应用要封装成可复用库，但客户端已有同名应用，触发Django应用名唯一限制
• 将应用重命名为mycompany_organizations并完成迁移后，数据库表仍保留旧名organizations_organization
• 给MyCompanyOrganization模型设置db_table="my_company_organization"并生成迁移执行后，表名未变更
• 手动编写的重命名表迁移代码也无效
• 临时解决：新增对旧organizations应用最新迁移的依赖后生效，但逻辑上该依赖已执行，疑似Django Bug

可行解决步骤 #

1. 显式声明迁移依赖 #

Django迁移的执行顺序由dependencies控制，即使旧迁移已执行，显式声明依赖能避免Django跳过表结构变更：

# 新的重命名迁移文件内容
from django.db import migrations

class Migration(migrations.Migration):
    dependencies = [
        ('organizations', '0005_last_old_migration'),  # 替换为旧应用的最后一个迁移文件名
        ('mycompany_organizations', '0001_initial'),
    ]

    operations = [
        migrations.RenameTable(
            old_table_name='organizations_organization',
            new_table_name='my_company_organization',
        ),
    ]

2. 重置迁移状态 #

如果Django缓存了旧的迁移状态，执行以下命令强制刷新：

# 先将mycompany_organizations的迁移状态重置到初始
python manage.py migrate --fake mycompany_organizations zero
# 重新执行所有迁移
python manage.py migrate mycompany_organizations

注意：--fake仅修改迁移状态，不会改动数据库，操作前务必备份数据。

3. 确认模型配置正确性 #

检查模型的db_table和app_label设置，避免应用标签混淆：

from django.db import models

class MyCompanyOrganization(models.Model):
    name = models.CharField(max_length=100)
    # 其他字段...

    class Meta:
        db_table = 'my_company_organization'
        app_label = 'mycompany_organizations'  # 显式指定应用标签，防止与旧应用混淆

同时确保mycompany_organizations已正确添加到settings.py的INSTALLED_APPS中，移除旧的organizations应用。

4. 排查迁移冲突 #

• 检查是否存在多个迁移文件修改同一张表，导致Django执行顺序混乱
• 确认旧organizations应用已从INSTALLED_APPS中移除，避免Django优先处理旧应用的表结构

5. 手动修正（极端场景） #

如果上述方法均无效，可手动修改数据库表名（需停机操作），再标记迁移已完成：

-- 执行SQL重命名表
ALTER TABLE organizations_organization RENAME TO my_company_organization;

执行后，运行以下命令标记迁移已完成：

python manage.py migrate --fake mycompany_organizations 0002_rename_organization_table

替换0002_rename_organization_table为你的重命名迁移文件名

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