部署Django应用时模型失效：数据库表不存在问题求助

1. 检查应用注册正确性 #

确认settings.py的INSTALLED_APPS中是否正确添加了子应用，Django要求应用名与实际目录名一致（通常为小写）：

# settings.py
INSTALLED_APPS = [
    # 其他应用
    'webshop_dashboard',  # 注意是小写，而非'WebshopDashboard'
]

2. 验证模型与迁移文件的表名配置 #

Django默认生成的表名为小写应用名_小写模型名（如webshopdashboard_product），错误提示的WebshopDashboard_product（首字母大写）通常是表名配置错误导致：

• 检查模型的Meta类，避免手动指定错误的表名：

  # WebshopDashboard/models.py
  class Product(models.Model):
      # 字段定义
      class Meta:
          # 要么删除db_table让Django自动生成，要么指定正确的小写表名
          db_table = 'webshopdashboard_product'
  

• 查看迁移文件（如webshop_dashboard/migrations/0001_initial.py）中的CreateModel操作，确认db_table参数正确：

  migrations.CreateModel(
      name='Product',
      fields=[
          # 字段列表
      ],
      options={
          'db_table': 'webshopdashboard_product',
      },
  )
  

3. 确保迁移命令正确执行 #

部署环境中可能未执行子应用的迁移，需明确指定应用执行迁移：

# 先执行WebshopDashboard应用的迁移
python manage.py migrate webshop_dashboard
# 再执行所有未完成的迁移（可选）
python manage.py migrate

同时确认数据库用户拥有创建表的权限。

4. 检查数据库连接配置 #

确认settings.py中的DATABASES配置指向部署环境的正确数据库，避免与本地库混淆：

# settings.py
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',  # 根据实际数据库类型调整
        'NAME': 'your_deploy_db',
        'USER': 'deploy_db_user',
        'PASSWORD': 'deploy_db_password',
        'HOST': 'db_host',
        'PORT': 'db_port',
    }
}

可通过python manage.py dbshell连接部署数据库，手动查询是否存在目标表：

-- PostgreSQL示例
SELECT table_name FROM information_schema.tables WHERE table_schema = 'public';

5. 同步迁移文件并重建（极端情况） #

若本地与部署环境迁移文件不一致，可尝试重建迁移（注意：此操作会丢失现有数据，需先备份）：

# 删除应用下的迁移文件（保留__init__.py）
rm -rf webshop_dashboard/migrations/*.py
# 重新生成初始迁移
python manage.py makemigrations webshop_dashboard
# 重新执行迁移
python manage.py migrate webshop_dashboard

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