Django开发与生产环境分离数据库及迁移管理问题求助

一、先解决当前迁移报错问题 #

你的核心报错是因为视图模块加载时直接执行了数据库查询（PostTags.objects.all()在PostFilter类定义阶段运行），而迁移命令执行时会提前导入URL和视图，此时数据库表还未创建，导致报错。

解决方法：

• 延迟查询到类实例化阶段：

  # 修改前
  class PostFilter(django_filters.FilterSet):
      # 错误写法：类加载时直接查询数据库
      tag = django_filters.ChoiceFilter(choices=[(t.tag, t.tag) for t in PostTags.objects.all()])
  
  # 修改后
  class PostFilter(django_filters.FilterSet):
      tag = django_filters.ChoiceFilter(choices=[])
  
      def __init__(self, *args, **kwargs):
          super().__init__(*args, **kwargs)
          # 实例化时才执行数据库查询
          self.filters['tag'].extra['choices'] = [(t.tag, t.tag) for t in PostTags.objects.all()]
  

• 或者使用懒加载方式：

  from django.utils.functional import lazy
  
  def get_tag_choices():
      return [(t.tag, t.tag) for t in PostTags.objects.all()]
  
  class PostFilter(django_filters.FilterSet):
      tag = django_filters.ChoiceFilter(choices=lazy(get_tag_choices, list)())
  

二、开发/生产环境分库的最佳实践 #

1. 配置文件拆分 #

创建多环境隔离的配置文件，避免硬编码：

• 项目根目录新建config文件夹，包含：
  • base.py：公共配置（INSTALLED_APPS、MIDDLEWARE、SECRET_KEY等）
  • dev.py：开发环境专属配置（DEBUG=True、开发数据库信息）
  • prod.py：生产环境专属配置（DEBUG=False、生产数据库信息）
• 主settings.py通过环境变量切换配置：

  import os
  
  ENV = os.environ.get('DJANGO_ENV', 'dev')
  
  if ENV == 'prod':
      from .config.prod import *
  else:
      from .config.dev import *
  

• 开发环境数据库配置示例（config/dev.py）：

  DATABASES = {
      'default': {
          'ENGINE': 'django.db.backends.postgresql',
          'NAME': 'dev_stokk_db',
          'USER': 'dev_user',
          'PASSWORD': 'dev_password',
          'HOST': 'localhost',
          'PORT': '5432',
      }
  }
  

  生产环境仅需替换config/prod.py中的数据库参数即可。

2. 迁移管理方案 #

• 环境迁移执行：迁移文件是代码的一部分，统一提交到版本控制，不同环境执行迁移时指定对应配置：
  • 开发环境：

    export DJANGO_ENV=dev
    python manage.py migrate
    

  • 生产环境：

    export DJANGO_ENV=prod
    python manage.py migrate
    

• 新环境数据库初始化：
  1. 若是全新开发库：直接执行migrate即可自动创建所有表
  2. 若需同步生产库结构：
     • 从生产导出结构：pg_dump -s -d prod_db > prod_schema.sql
     • 开发库导入结构：psql -d dev_db -f prod_schema.sql
     • 执行python manage.py migrate --fake，让Django标记所有迁移已完成
• 迁移冲突规避：团队成员执行迁移前先拉取最新代码，确保使用同一套迁移文件；不要手动修改迁移文件，所有结构变更通过makemigrations生成。

三、额外注意事项 #

• 禁止在模块级别（类定义、全局变量）执行数据库查询，这类代码会在Django启动时自动执行，迁移、命令行工具运行时都会触发。
• 敏感信息（数据库密码、API密钥等）通过环境变量传递，不要硬编码到配置文件。
• 开发环境可临时使用SQLite快速测试，但生产环境必须使用PostgreSQL/MySQL等正式数据库，避免迁移兼容性问题。

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