MacOS系统下Django故障求助：迁移操作后全项目报错

嘿，我之前踩过几乎一模一样的坑，别慌，咱们从数据库和环境两个核心方向入手排查解决：

1. 清理数据库的迁移残留记录 #

你删除了本地迁移文件，但数据库里的django_migrations表还存着旧的迁移记录，这是最常见的冲突根源：

• 运行命令进入项目数据库：python manage.py dbshell
• 执行SQL语句删除对应项目的迁移记录（如果所有项目都出问题，直接清空整个表）：

  DELETE FROM django_migrations;
  

• 退出数据库shell，如果你用的是SQLite，直接删除项目根目录下的db.sqlite3；如果是PostgreSQL/MySQL这类数据库，删掉对应数据库后重新创建

2. 彻底清理Python环境缓存 #

重装Django还没解决，大概率是环境里有残留的缓存文件搞鬼：

• 批量删除项目所有目录下的__pycache__文件夹：find . -name "__pycache__" -type d -exec rm -rf {} +
• 如果用了虚拟环境，直接删掉旧环境重建，避免残留损坏的依赖：

  rm -rf venv/
  python -m venv venv
  source venv/bin/activate  # Windows系统用 venv\Scripts\activate
  pip install django==你正在使用的版本
  

• 执行pip cache purge清空pip的缓存，防止安装到损坏的包文件

3. 验证新建项目的环境隔离性 #

如果新建项目也报错，说明你的全局Python环境可能被污染了：

• 强制用全新虚拟环境创建测试项目，确保环境隔离：

  python -m venv new_test_venv
  source new_test_venv/bin/activate
  django-admin startproject new_test_project
  cd new_test_project
  python manage.py migrate
  

  如果这个测试项目能正常运行，说明之前的项目有残留问题；如果还是报错，建议用pyenv这类工具重新安装Python，彻底清理全局环境

4. 重置原项目的迁移流程 #

回到原项目，按标准流程重建迁移：

• 删除所有app下的migrations文件夹（记得保留里面的__init__.py）
• 运行python manage.py makemigrations重新生成初始迁移文件
• 运行python manage.py migrate --fake-initial，用--fake-initial避免重复创建已存在的数据库表

重要提醒：如果你的数据库里有重要业务数据，一定要先备份再执行数据库重置操作！

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