Django提示迁移未知应用authtoken：如何排查并解决该问题？

第一步：确认具体未应用的迁移信息 #

先执行命令查看authtoken应用的迁移状态，明确是哪条迁移未应用：

python manage.py showmigrations authtoken

输出中未标记[X]的就是未应用的迁移，记下它的名称（比如0002_auto_xxxxxx_xxxx）。

排查可能的原因 #

1. 依赖包版本变更 #

即使Git分支未改动，本地虚拟环境的djangorestframework版本可能被悄悄更新，而新版本的authtoken模块新增了迁移文件。执行以下命令查看当前DRF版本：

pip show djangorestframework

对比项目requirements.txt或pyproject.toml中指定的版本，若不一致说明依赖被意外升级。

2. 数据库连接配置错误 #

检查settings.py中的DATABASES配置，确认当前连接的数据库是否是项目常用的那一个。如果连接了新的测试库、备用库，或数据库路径（如SQLite的db文件）被修改，会导致迁移记录不同步。

3. 本地迁移文件被篡改 #

虽然Git分支未提交变更，但可能本地对authtoken的迁移文件做了未跟踪的修改或误删。执行以下命令检查：

git status
git diff <项目根目录>/rest_framework/authtoken/migrations/

若有未提交的修改，说明本地文件与仓库版本不一致。

4. Django迁移缓存问题 #

Django会缓存迁移状态，偶尔缓存失效会导致错误提示。尝试清除缓存并重启服务器：

python manage.py clearcache

对应的解决方法 #

1. 合法迁移：直接应用 #

如果确认未应用的迁移是DRF版本更新带来的合法迁移，执行命令应用：

python manage.py migrate authtoken

2. 版本回退：恢复依赖版本 #

若依赖被意外升级，回退到项目指定的DRF版本：

pip install djangorestframework==<指定版本号>

之后再次执行showmigrations确认迁移状态是否正常。

3. 修复数据库连接 #

修正settings.py中的DATABASES配置，连接回正确的数据库，再重新查看迁移状态。

4. 恢复迁移文件 #

如果本地迁移文件被篡改，用Git恢复到仓库版本：

git checkout -- <authtoken迁移文件路径>

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