基于Django与MongoDB的打印店Web应用迁移KeyError问题咨询

错误含义 #

这个错误表示Django在构建项目迁移状态时，尝试对products应用下名为product的模型执行字段添加操作，但找不到该模型的定义。核心原因是迁移文件与当前项目的模型结构不同步。

可能原因及解决方向 #

1. 迁移文件与当前模型脱节 #

• 你可能已经删除、重命名了products应用中的Product模型，但旧迁移文件仍保留着针对该模型的操作（比如AddField）。Django加载这些迁移时，找不到对应模型就会抛出KeyError。
• 解决：检查products/migrations/目录下的所有迁移文件，定位包含('products', 'product')操作的文件，手动移除或修改无效操作；如果是测试环境，可直接删除该应用下除__init__.py外的所有迁移文件，清空数据库中django_migrations表对应products的记录，重新执行python manage.py makemigrations和python manage.py migrate。

2. 迁移依赖链断裂 #

• 某个迁移文件依赖了已被修改或删除的迁移，导致Django回溯迁移状态时无法定位到目标模型。
• 解决：执行python manage.py showmigrations products查看该应用的迁移状态，确认已应用和未应用的迁移，排查依赖缺失或冲突情况，调整迁移文件的dependencies字段。

3. MongoDB适配库兼容性问题 #

• 由于你使用MongoDB而非Django默认的关系型数据库，djongo等适配库可能存在迁移逻辑兼容性问题，导致模型状态识别错误。
• 解决：检查适配库版本与当前Django版本是否兼容，尝试升级到最新稳定版；NoSQL场景下可简化迁移操作，避免复杂字段变更逻辑。

报错回溯信息 #

Traceback (most recent call last):
  File "C:\Users\shamz\OneDrive\Desktop\shobi\double2_Project\double_two_Print\manage.py", line 22, in <module>
    main()
  File "C:\Users\shamz\OneDrive\Desktop\shobi\double2_Project\double_two_Print\manage.py", line 18, in main
    execute_from_command_line(sys.argv)
  File "C:\Users\shamz\OneDrive\Desktop\shobi\double2_Project\shoaiba\Lib\site-packages\django\core\management\__init__.py", line 446, in execute_from_command_line
    utility.execute()
  File "C:\Users\shamz\OneDrive\Desktop\shobi\double2_Project\shoaiba\Lib\site-packages\django\core\management\__init__.py", line 440, in execute
    self.fetch_command(subcommand).run_from_argv(self.argv)
  File "C:\Users\shamz\OneDrive\Desktop\shobi\double2_Project\shoaiba\Lib\site-packages\django\core\management\base.py", line 402, in run_from_argv
    self.execute(*args, **cmd_options)
  File "C:\Users\shamz\OneDrive\Desktop\shobi\double2_Project\shoaiba\Lib\site-packages\django\core\management\base.py", line 448, in execute
    output = self.handle(*args, **options)
             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\shamz\OneDrive\Desktop\shobi\double2_Project\shoaiba\Lib\site-packages\django\core\management\base.py", line 96, in wrapped
    res = handle_func(*args, **kwargs)
          ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\shamz\OneDrive\Desktop\shobi\double2_Project\shoaiba\Lib\site-packages\django\core\management\commands\makemigrations.py", line 196, in handle
    loader.project_state(),
    ^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\shamz\OneDrive\Desktop\shobi\double2_Project\shoaiba\Lib\site-packages\django\db\migrations\loader.py", line 361, in project_state
    return self.graph.make_state(
           ^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\shamz\OneDrive\Desktop\shobi\double2_Project\shoaiba\Lib\site-packages\django\db\migrations\graph.py", line 329, in make_state
    project_state = self.nodes[node].mutate_state(project_state, preserve=False)
                    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\shamz\OneDrive\Desktop\shobi\double2_Project\shoaiba\Lib\site-packages\django\db\migrations\migration.py", line 89, in mutate_state
    operation.state_forwards(self.app_label, new_state)
  File "C:\Users\shamz\OneDrive\Desktop\shobi\double2_Project\shoaiba\Lib\site-packages\django\db\migrations\operations\fields.py", line 93, in state_forwards
    state.add_field(
  File "C:\Users\shamz\OneDrive\Desktop\shobi\double2_Project\shoaiba\Lib\site-packages\django\db\migrations\state.py", line 248, in add_field
    self.models[model_key].fields[name] = field
    ~~~~~~~~~~~^^^^^^^^^^^
KeyError: ('products', 'product')

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