如何为本地开发与Docker部署配置不同的Django数据库

方案1：通过环境变量区分环境加载配置 #

无需拆分配置文件，仅通过新增环境标识变量，动态切换数据库参数。

1. 新增环境标识变量
   在现有.env中添加环境标识：

   ENVIRONMENT=docker  # Docker环境设为docker，本地开发时改为local
   

   本地开发建议单独创建.env.local文件（添加到.gitignore避免提交），内容示例：

   ENVIRONMENT=local
   DATABASE_NAME=本地数据库名
   DATABASE_USER=本地数据库用户名
   DATABASE_PASS=本地数据库密码
   HOST=localhost
   PORT=5432
   

2. 修改settings.py数据库配置逻辑
   通过环境标识动态调整数据库HOST：

   DATABASES = {
       "default": {
           'ENGINE': 'django.db.backends.postgresql_psycopg2',
           'NAME': env('DATABASE_NAME'),
           'USER': env('DATABASE_USER'),
           'PASSWORD': env('DATABASE_PASS'),
           'HOST': env('HOST') if env('ENVIRONMENT') == 'docker' else 'localhost',
           "PORT": env('PORT'),
       }
   }
   

   若使用python-dotenv，可在项目入口（如manage.py）优先加载本地配置文件：

   from dotenv import load_dotenv
   import os
   
   # 优先加载本地.env.local
   load_dotenv('.env.local')
   # 再加载默认.env
   load_dotenv()
   

方案2：拆分配置文件（适合复杂项目） #

将配置拆分为通用基础配置和环境专属配置，通过指定DJANGO_SETTINGS_MODULE切换。

1. 创建配置文件结构

   项目根目录/
     settings/
       __init__.py
       base.py       # 通用配置（INSTALLED_APPS、MIDDLEWARE等）
       local.py      # 本地开发配置
       docker.py     # Docker部署配置
   

2. 迁移通用配置到base.py
   将原settings.py中除数据库外的通用配置（如SECRET_KEY、INSTALLED_APPS）复制到base.py，并在末尾添加：

   from dotenv import load_dotenv
   load_dotenv()
   

3. 编写local.py

   from .base import *
   
   DATABASES = {
       "default": {
           'ENGINE': 'django.db.backends.postgresql_psycopg2',
           'NAME': '本地数据库名',
           'USER': '本地数据库用户名',
           'PASSWORD': '本地数据库密码',
           'HOST': 'localhost',
           "PORT": '5432',
       }
   }
   

4. 编写docker.py

   from .base import *
   
   DATABASES = {
       "default": {
           'ENGINE': 'django.db.backends.postgresql_psycopg2',
           'NAME': env('DATABASE_NAME'),
           'USER': env('DATABASE_USER'),
           'PASSWORD': env('DATABASE_PASS'),
           'HOST': env('HOST'),
           "PORT": env('PORT'),
       }
   }
   

5. 运行时指定配置文件

   • 本地开发：

     python manage.py runserver --settings=项目名.settings.local
     

     或提前设置环境变量：

     export DJANGO_SETTINGS_MODULE=项目名.settings.local
     python manage.py runserver
     

   • Docker部署：在docker-compose.yaml的web服务中添加环境变量：

     environment:
       - DJANGO_SETTINGS_MODULE=项目名.settings.docker
     

注意事项 #

• 本地开发前需确保已创建对应PostgreSQL数据库和用户，权限配置正确。
• 将.env.local加入.gitignore，避免敏感信息提交到代码仓库。
• Docker环境下depends_on仅保证服务启动顺序，若需等待数据库完全就绪，可添加wait-for-it脚本（如command: wait-for-it db:5432 -- python manage.py runserver 0.0.0.0:8000）。

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