修改Django应用名称与数据库表后无法执行makemigrations

这个KeyError: ('cancer_trials', 'cancer_trials')的核心原因很明确：你的迁移文件、数据库迁移历史或者模型元数据里，还残留着旧应用名称clinicaltrials的引用，导致Django在构建迁移状态时，找不到对应新应用下的模型记录。咱们一步步来修复：

1. 检查并更新模型的Meta配置 #

打开cancer_trials应用下所有models.py文件，确保每个模型的Meta类里的app_label都设置为新名称：

class YourModel(models.Model):
    # 模型字段定义...
    class Meta:
        app_label = 'cancer_trials'  # 替换掉原来的clinicaltrials，没有的话直接添加

如果之前没显式设置app_label，Django会自动识别应用目录名，但重命名后可能存在同步延迟，显式声明能避免歧义。

2. 批量修正迁移文件里的旧应用引用 #

进入cancer_trials/migrations目录，逐个打开迁移文件，做两处关键修改：

• 迁移类的app_label属性和依赖项：

  class Migration(migrations.Migration):
      app_label = 'cancer_trials'  # 替换原来的clinicaltrials
      dependencies = [
          # 把所有('clinicaltrials', 'xxxx')改成('cancer_trials', 'xxxx')
          ('cancer_trials', '0001_initial'),
      ]
  

• 迁移操作里的app_label参数：比如CreateModel、AlterField等操作中，如果指定了app_label，全部替换为cancer_trials。

3. 更新数据库里的迁移历史记录 #

Django依赖django_migrations表跟踪迁移历史，旧应用名称会导致状态不匹配。你可以通过Django Shell执行SQL更新：

python manage.py shell

在Shell中执行：

from django.db import connection
with connection.cursor() as cursor:
    cursor.execute("UPDATE django_migrations SET app = 'cancer_trials' WHERE app = 'clinicaltrials';")

也可以直接用数据库客户端执行这条SQL语句。

4. 清理缓存并验证 #

• 清理PyCharm缓存：点击File > Invalidate Caches...，选择"Invalidate and Restart"重启IDE
• 清理Django缓存：删除项目根目录下的__pycache__文件夹，或者运行：

  python manage.py clearcache
  

5. 重新执行迁移操作 #

现在尝试生成新的迁移：

python manage.py makemigrations cancer_trials

如果提示"no changes detected"，说明状态已同步，直接执行迁移即可：

python manage.py migrate cancer_trials

错误原因补充 #

你遇到的报错出现在state_forwards方法里，是因为迁移操作试图从当前状态中获取(cancer_trials, cancer_trials)模型，但由于迁移文件或数据库历史里的旧应用名残留，Django的状态构建器找不到对应记录——本质就是新旧应用名称的引用没有完全替换干净。

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