Django makemigrations未检测到Waterfall模型问题排查

一、Waterfall模型未生成表的核心原因 #

Django默认只会自动扫描每个应用根目录下的models.py文件，你将Waterfall模型拆分到了API/Waterfall/waterfall_model.py子模块中，Django无法自动发现这个文件里的模型类，因此不会为它生成数据库表和迁移记录。

二、解决方法 #

你需要让Django能加载到子模块中的模型，有两种常用方式：

方式1：在应用的__init__.py中导入模型 #

在API/__init__.py文件中添加导入语句，把拆分到子模块的模型引入：

from .Waterfall.waterfall_model import Waterfall
from .Peak.peak_model import Peak
# 其他子模块的模型同理导入

这样Django在初始化应用时，就能扫描到这些模型类。

方式2：通过自定义AppConfig加载子模块 #

1. 修改API/apps.py中的AppConfig类，在ready()方法中导入子模块：

from django.apps import AppConfig

class ApiConfig(AppConfig):
    default_auto_field = 'django.db.models.BigAutoField'
    name = 'api'

    def ready(self):
        # 导入所有子模块的模型文件
        from .Waterfall import waterfall_model
        from .Peak import peak_model

2. 在API/__init__.py中指定默认的AppConfig：

default_app_config = 'api.apps.ApiConfig'

三、关于迁移中的"Add field region to department" #

这是Django生成迁移时的正常逻辑，和你清空数据库、删除迁移文件无关。出现这个步骤的原因通常是：

• Department模型和Region模型存在依赖关系（比如region是外键字段）
• Django在生成迁移时，会先创建没有外键的Department基础表，再单独添加关联Region的字段（因为需要确保Region表已存在）
  只要最终数据库结构符合你的模型定义，这个拆分的迁移步骤无需在意。

额外检查项 #

• 确认settings.py的INSTALLED_APPS中已经正确添加了'api'应用
• 检查父类Natural模型的定义：如果Natural是抽象基类（设置了abstract = True），Waterfall会生成独立表；如果是普通模型，Waterfall会以多表继承的方式生成关联表，但前提是Django能识别到Waterfall模型

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