Docker部署Django时migrate前触发myapp_menu表不存在错误

问题根源 #

Docker启动流程中，Django在执行migrate前会先加载URL配置，而你的代码中在模块级别（如表单类、URL定义处）直接执行了数据库查询（比如表单的ModelChoiceField直接赋值了queryset=Menu.objects.all()），导致提前访问未创建的myapp_menu表。本地环境正常是因为本地数据库已经执行过迁移，表已存在。

具体解决方案 #

1. 延迟数据库查询到运行时 #

将表单或模块级别的DB查询逻辑移到方法内部，避免在模块加载时触发查询：

# 错误写法（模块加载时就执行查询）
class MenuForm(forms.Form):
    menu = forms.ModelChoiceField(queryset=Menu.objects.all())

# 正确写法（在表单初始化时才执行查询）
class MenuForm(forms.Form):
    menu = forms.ModelChoiceField(queryset=Menu.objects.none())

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 延迟到初始化时才查询数据库
        self.fields['menu'].queryset = Menu.objects.all()

同理，避免在视图文件顶部、URL配置等模块级代码中执行Menu.objects.xxx这类DB操作，把这些逻辑放到视图函数内部。

2. 强制Docker启动时先完成迁移再启动服务 #

修改docker-compose.yml中Django服务的启动命令，确保migrate执行完成后再启动服务：

services:
  catering-django:
    # 替换原来的command，先执行迁移再启动服务
    command: sh -c "python manage.py migrate --no-input && python manage.py runserver 0.0.0.0:8000"

如果使用了自定义entrypoint脚本，也可以在脚本中加入python manage.py migrate --no-input命令，放在启动服务的命令之前。

3. 检查URL配置中的提前执行逻辑 #

确保URLconf中没有在定义时触发DB查询的代码，比如：

• 错误：path('menu/<int:pk>/', views.MenuDetail.as_view(initial={'menu': Menu.objects.get(pk=1)}))
• 正确：将这类初始化逻辑移到视图的get_initial()方法中，避免在URL加载时执行查询。

验证步骤 #

1. 删除现有Docker镜像、容器、卷（你已经尝试过，可跳过）
2. 重新构建镜像：docker-compose build
3. 启动服务：docker-compose up
4. 观察catering-django容器日志，确认migrate先执行完成，服务正常启动。

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