解决 Django 迁移报错：Related model 'telegrambot.User' cannot be resolved

问题定位与复现

当执行 ./manage.py test 时，Django 会尝试在测试数据库中应用所有迁移。如果某个 Migration 文件引用了尚未被正确识别的模型（例如 telegrambot.User），系统会抛出上述 ValueError。这通常发生在 App 之间存在交叉引用，但 Migration 的依赖链未正确建立时。

排查步骤

1. 手动创建测试数据库：确保测试环境数据库存在。
2. 手动执行迁移以获取详细输出：通过命令行强制运行迁移，以便观察具体的报错堆栈。

./manage.py migrate --database test

执行后，观察控制台输出，定位到具体出错的 Migration 文件。通常错误信息会指向某个特定的 App 和 Migration 版本。

修复方案

检查报错对应的 Migration 文件，发现其 dependencies 列表中未包含相关 App（如 telegrambot）的依赖。虽然调整 settings.py 中 INSTALLED_APPS 的顺序有时能缓解部分加载问题，但根本解决方式是在 Migration 中显式声明依赖。

在出错的 Migration 文件中，添加对 telegrambot App 的依赖。例如，若 telegrambot 的初始迁移版本为 0001_initial，则修改如下：

class Migration(migrations.Migration):

  dependencies = [
+    ('telegrambot', '0001_initial'),
    ('powernews', '0004_applenews'),
  ]

添加后，再次执行 ./manage.py test，Django 将能正确解析模型关系，问题即可解决。

总结

Django 的 Migration 系统严格依赖依赖链的正确性。当遇到模型无法解析的错误时，优先检查相关 Migration 文件的 dependencies 是否完整。手动补全缺失的 App 依赖是解决此类问题的标准做法。

以上就是修复 Django migration 时遇到 Related model cannot be resolved 错误的详细内容，更多关于 Django 迁移调试的资料请关注本站其它相关文章！