Docker容器中运行Django：启动时makemigrations/migrate无法识别应用模型

我来帮你搞定这个头疼的问题——项目级迁移能正常跑，但应用级模型的迁移就是识别不了，这种情况我在日常开发中碰到过好几次，大概率是下面几个原因导致的，咱们一个个排查：

1. 应用没加入INSTALLED_APPS #

这是最容易踩的坑！Django只会对settings.py里INSTALLED_APPS列表中的应用生成迁移文件。打开你的settings.py，确认你的应用名称（比如myapp）已经添加进去了：

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    ...
    'myapp',  # 确保这一行存在！
]

2. 迁移文件没被复制到容器内 #

检查你的Dockerfile和.dockerignore配置：

• Dockerfile：确保你把整个项目（包括应用目录）都复制到了容器里，比如用COPY . /app而不是只复制项目根目录下的部分文件；
• .dockerignore：有没有不小心把migrations/目录排除了？如果有，要修改成只忽略migrations/__pycache__/和migrations/*.pyc，保留migrations/__init__.py和已有的迁移文件，不然容器里根本没有迁移文件的基础。

3. makemigrations没指定具体应用 #

如果你的项目里有多个应用，直接跑python manage.py makemigrations可能不会自动检测到新添加的应用模型（尤其是刚创建的应用）。修改你的launch.sh脚本，指定要生成迁移的应用名称：

#!/bin/bash
# 为指定应用生成迁移文件，多个应用用空格分隔
python manage.py makemigrations myapp mysecondapp --no-input --verbosity 1
# 执行所有未应用的迁移
python manage.py migrate --no-input --verbosity 1
# 别忘了启动Django服务（如果你的脚本里没加的话）
python manage.py runserver 0.0.0.0:8000

4. 容器内迁移文件权限异常 #

如果你的容器用了非root用户运行，可能会出现迁移文件无法读取的情况。在Dockerfile里添加权限设置：

# 创建django用户（如果还没创建）
RUN useradd -m django
# 把项目目录的权限交给django用户
RUN chown -R django:django /app
# 切换到django用户运行
USER django

5. 手动排查迁移状态 #

如果上面的方法都没用，进入容器手动检查迁移状态：

1. 进入容器：docker exec -it <你的容器ID/名称> bash
2. 查看所有应用的迁移状态：python manage.py showmigrations
3. 针对目标应用手动生成迁移：python manage.py makemigrations myapp
4. 手动应用迁移：python manage.py migrate myapp
   通过这几步可以定位到底是生成迁移的问题，还是应用迁移的问题。

内容的提问来源于stack exchange，提问作者Carl F. Hostetter