无迁移文件的旧Django项目对接空数据库的正确启动步骤

你列出的三条命令无法保证项目在全新空数据库环境下正常启动，对于无历史迁移文件、包含50个跨应用外键关联模型的旧Django项目，直接执行这三条命令大概率会触发依赖顺序错误、关联表不存在、非空字段缺默认值等各类报错，需要按以下规范步骤操作。

• 前置环境校验
  • 激活项目对应的虚拟环境，执行pip install -r requirements.txt安装全量依赖，包括Django版本、对应数据库的驱动（如psycopg2-binary、mysqlclient）、项目引用的第三方Django插件，避免后续执行命令时出现导入错误。
  • 打开项目settings.py文件，核对DATABASES配置项，确保连接的是提前建好的全新空数据库，账号拥有建表、修改表结构的完整权限；同时确认10个业务应用全部已注册到INSTALLED_APPS列表中，漏注册会导致后续扫描模型时找不到关联的外键模型。
• 生成初始迁移文件
  • 不要直接全局执行makemigrations，先按依赖优先级逐个为业务应用生成迁移：优先给不依赖其他业务应用模型的基础应用执行python manage.py makemigrations <应用名>，再逐次处理依赖上层的应用。如果执行时提示某外键关联的模型不存在，先为被依赖的应用生成迁移后，再回到当前应用操作。
  • 所有业务应用单独生成完迁移后，再执行一次全局python manage.py makemigrations，正常情况会提示No changes detected，如果仍生成新的迁移文件，需要检查跨应用外键的依赖配置是否正确。
  • 逐一检查生成的迁移文件：确认跨应用外键对应的迁移条目，已经在dependencies配置项中正确声明了对关联应用对应迁移的依赖，避免后续迁移时因表创建顺序不对触发外键约束错误；同时排查所有非空字段，要么提前配置default默认值，要么准备好迁移交互时需要填入的临时默认值，避免流程卡住。
  • 如果存在循环外键依赖（A表外键关联B表，B表外键同时关联A表），可以先给其中一个外键加上db_constraint=False参数，等两张表都创建完成后，再单独生成迁移补加约束，也可以用SeparateDatabaseAndState方法把建表和加外键的步骤拆到不同迁移里执行。
• 执行数据库迁移
  • 先执行python manage.py migrate，优先完成Django内置应用（auth、contenttypes、admin、sessions等）的表创建，这一步一般不会出现异常。
  • 业务应用迁移过程中如果出现外键报错，直接查看报错信息里提到的关联表，调整对应迁移文件的依赖顺序，把被关联表的迁移放到当前迁移的依赖列表中，再重新执行migrate命令即可。
• 启动前校验
  • 迁移全部执行完成无报错后，先执行python manage.py check做全量项目体检，排查模型配置、路由配置、静态文件配置等层面的显性错误。
  • 按项目需要导入初始数据：可以通过python manage.py loaddata <fixture文件路径>导入提前准备好的基础数据，执行python manage.py createsuperuser创建后台管理员账号，也可以运行项目自定义的初始化脚本完成数据初始化。
  • 如果是生产环境部署，需要额外执行python manage.py collectstatic收集所有静态文件到指定目录；开发环境调试则确认DEBUG参数为True即可。
• 启动服务
  • 开发环境直接执行python manage.py runserver即可，需要指定端口或允许外部访问时，可以追加参数比如python manage.py runserver 0.0.0.0:8000。

你提到的三条命令仅能在「项目迁移文件齐全、模型无复杂跨应用依赖、所有非空字段配置了合理默认值、数据库和依赖环境完全配置正确」的理想场景下正常工作。针对你当前无历史迁移、存在大量关联模型的旧项目场景，直接执行会大概率碰到应用漏扫、外键顺序错误建表失败、非空字段缺默认值卡住流程、循环依赖报错、数据库连接失败等问题，无法一次性完成启动。

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