如何将Django迁移文件移至项目外部？配置及实践疑问

一、正确配置MIGRATION_MODULES指向自定义目录 #

你的配置错误在于使用了相对路径，Django的MIGRATION_MODULES要求填写绝对Python包路径，不能用..这种相对路径写法，而且你指定的db_migrations目录也不存在，导致报错。按照你的项目结构，正确配置步骤如下：

1. 先把目标迁移目录变成Python可导入的包：

   • 在django-project/migrations/目录下创建__init__.py文件
   • 在django-project/migrations/app1/目录下也创建__init__.py文件

2. 在src/config/settings.py中修改MIGRATION_MODULES配置：

   MIGRATION_MODULES = {
       'app1': 'migrations.app1'
   }
   

   配置完成后，运行python manage.py makemigrations app1，迁移文件就会生成到django-project/migrations/app1/目录下。

二、迁移文件移出默认位置是否属于不良实践？ #

这不是绝对的不良实践，要结合项目场景判断：

• 合理适用场景：

  • 大型项目包含多个APP，希望统一管理所有迁移文件，避免分散在各APP目录下；
  • 需要分离业务代码（src/下的APP）与配置/迁移类文件，让目录结构更清晰；
  • 团队有统一代码规范，要求迁移文件独立存放。

• 需要规避的风险：

  • 必须确保迁移目录是合法的Python包（存在__init__.py），否则Django无法识别；
  • 所有团队成员的开发环境要保持一致配置，避免因路径问题导致迁移失败；
  • 不要随意移动已生成的迁移文件，否则会破坏Django的迁移历史记录，引发后续迁移错误；
  • 版本控制必须包含自定义迁移目录，否则其他成员拉取代码后无法正常执行迁移。

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