Django迁移报错：依赖引用不存在父节点的问题排查与预防

嘿，我之前处理过好几次这种Django迁移链断裂的问题，别慌，咱们一步步来修复：

一、紧急修复步骤 #

1. 定位问题根源 #

报错提示patients.0007_uploadedimages_processed_image依赖的父节点0006_auto_20190803_2241不存在，这说明迁移文件的依赖链断了——要么是0006这个迁移文件被误删（本地或服务器端），要么是远程仓库里根本没有这个文件，服务器拉取后自然找不到。

2. 修复迁移文件的依赖关系 #

找到服务器上的patients/migrations/0007_uploadedimages_processed_image.py文件，打开它修改dependencies部分：

dependencies = [
    # 把原来的('patients', '0006_auto_20190803_2241')替换成实际存在的上一个迁移
    ('patients', '0005_xxxxxx'),  # 这里填你实际存在的最后一个有效迁移文件名前缀
]

如果不确定上一个有效迁移是什么，直接看patients/migrations/目录里的文件，找序号最大且存在的那个（比如0005开头的文件）。

3. 同步数据库迁移记录 #

登录服务器的数据库，查询django_migrations表：

SELECT * FROM django_migrations WHERE app = 'patients';

如果表里有0006_auto_20190803_2241的记录，但服务器上没有对应的文件，需要删除这条记录（操作前务必备份数据库）：

DELETE FROM django_migrations WHERE app = 'patients' AND name = '0006_auto_20190803_2241';

4. 清理缓存并重新执行迁移 #

先清理服务器上的Python字节码文件，避免缓存干扰：

find /path/to/your/project -name "*.pyc" -delete

然后重新执行迁移：

python manage.py migrate patients

如果需要生成新的迁移，确保本地已经把完整的迁移链推送到远程，服务器拉取后再运行makemigrations（不要在服务器单独生成迁移，容易导致链不一致）。

二、后续预防方案 #

为了避免再碰到这种头疼的问题，记住这几个原则：

• 永远不要手动删除已推送到远程仓库的迁移文件：如果必须删除，要确保团队所有成员同步删除本地的对应文件，并且统一清理数据库里的迁移记录，否则必然出现依赖断裂。
• 本地先验证再推送：每次修改模型后，先在本地运行makemigrations和migrate，确认迁移正常执行、功能没问题，再把代码和迁移文件一起推送到远程。
• 服务器拉取后先核对迁移文件：拉取代码后，先检查migrations目录下的文件是否和本地完全一致，再执行migrate，不要随意删除服务器上的迁移文件。
• 用版本控制严格跟踪迁移文件：把migrations目录里的所有文件（除了__pycache__）都加入Git跟踪，确保本地、远程、服务器的迁移文件完全同步。
• 定期备份数据库：尤其是在执行迁移、修改迁移文件这类操作前，备份数据库能让你在出问题时快速回滚。

附你提供的错误回溯信息：

Traceback (most recent call last):
  File "manage.py", line 15, in <module>
    execute_from_command_line(sys.argv)
  File "/home/ubuntu/Eyelizer/eyenv/lib/python3.6/site-packages/django/core/management/__init__.py", line 381, in execute_from_command_line
    utility.execute()
  File "/home/ubuntu/Eyelizer/eyenv/lib/python3.6/site-packages/django/core/management/__init__.py", line 375, in execute
    self.fetch_command(subcommand).run_from_argv(self.argv)
  File "/home/ubuntu/Eyelizer/eyenv/lib/python3.6/site-packages/django/core/management/base.py", line 316, in run_from_argv
    self.execute(*args, **cmd_options)
  File "/home/ubuntu/Eyelizer/eyenv/lib/python3.6/site-packages/django/core/management/base.py", line 353, in execute
    output = self.handle(*args, **options)
  File "/home/ubuntu/Eyelizer/eyenv/lib/python3.6/site-packages/django/core/management/base.py", line 83, in wrapped
    res = handle_func(*args, **kwargs)
  File "/home/ubuntu/Eyelizer/eyenv/lib/python3.6/site-packages/django/core/management/commands/makemigrations.py", line 89, in handle
    loader = MigrationLoader(None, ignore_no_migrations=True)
  File "/home/ubuntu/Eyelizer/eyenv/lib/python3.6/site-packages/django/db/migrations/loader.py", line 49, in __init__
    self.build_graph()
  File "/home/ubuntu/Eyelizer/eyenv/lib/python3.6/site-packages/django/db/migrations/loader.py", line 273, in build_graph
    raise exc
  File "/home/ubuntu/Eyelizer/eyenv/lib/python3.6/site-packages/django/db/migrations/loader.py", line 247, in build_graph
    self.graph.validate_consistency()
  File "/home/ubuntu/Eyelizer/eyenv/lib/python3.6/site-packages/django/db/migrations/graph.py", line 243, in validate_consistency
    [n.raise_error() for n in self.node_map.values() if isinstance(n, DummyNode)]
  File "/home/ubuntu/Eyelizer/eyenv/lib/python3.6/site-packages/django/db/migrations/graph.py", line 243, in <listcomp>
    [n.raise_error() for n in self.node_map.values() if isinstance(n, DummyNode)]
  File "/home/ubuntu/Eyelizer/eyenv/lib/python3.6/site-packages/django/db/migrations/graph.py", line 96, in raise_error
    raise NodeNotFoundError(self.error_message, self.key, origin=self.origin)
django.db.migrations.exceptions.NodeNotFoundError: Migration patients.0007_uploadedimages_processed_image dependencies reference nonexistent parent node ('patients', '0006_auto_20190803_2241')

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