Django执行makemigrations报错“Settings already configured”的解决求助

• 检查重复配置触发点
  确认执行makemigrations/migrate时，没有手动提前导入django.conf.settings或调用django.setup()。Django管理命令会自动完成配置，重复操作会触发该错误。如果有自定义脚本调用Django组件，需添加判断：

  import django
  if not django.conf.settings.configured:
      django.setup()
  

• 彻底清理迁移文件
  除了清空app/migrations/__pycache__，还要删除migrations文件夹内除__init__.py外的所有.py迁移文件（如0001_initial.py），仅保留空的__init__.py。同时清空项目根目录和虚拟环境中的__pycache__文件夹。

• 重新初始化数据库

  1. 终止所有Django相关进程（如runserver、celery），避免数据库连接占用
  2. 登录MySQL执行命令重建数据库：

     DROP DATABASE your_db_name;
     CREATE DATABASE your_db_name CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
     

  3. 确认数据库用户拥有新数据库的完整操作权限

• 严格按流程执行迁移
  激活虚拟环境后依次执行：

  python manage.py makemigrations
  python manage.py migrate
  

  若使用自定义User模型，确保项目初始就配置了AUTH_USER_MODEL = 'yourapp.YourUserModel'，且未在迁移前生成过默认User相关表。

• 排查第三方库冲突
  检查INSTALLED_APPS中的第三方包，是否存在自动调用Django配置的库；同时确认wsgi.py/asgi.py文件未在命令行执行时被意外加载。

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