Django数据库配置避坑指南：从初始化到生产环境的实战优化
一、数据库配置介绍
Django 4.2 支持多种数据库后端
数据库类型推荐版本官方支持驱动 / 后端默认端口适用场景备注PostgreSQL12+✅psycopg2-binary5432生产、开发、测试支持高级字段类型（JSONField、ArrayField）MySQL5.7+（含 8.0）✅mysqlclient 或 mysql-connector-python3306生产、开发严格模式默认启用SQLite3.35+✅内置（无需额外驱动）无需端口开发、测试轻量级，不适合高并发生产环境Oracle12.2+✅cx_Oracle1521企业级应用配置较复杂，需额外依赖Microsoft SQL Server2017+❌django-pyodbc-azure1433企业级应用第三方后端支持Firebird3.0+❌django-firebird3050legacy 系统第三方后端支持TimescaleDB2.0+❌基于 PostgreSQL5432时间序列数据需额外配置配置MySQL数据库
Django项目配置文件：mysite\mysite\settings.py
实战示例：
### 数据库配置
DATABASE_HOST = "127.0.0.1"# 数据库地址
DATABASE_PORT = "3306"# 数据库端口
DATABASES = {
"default": {
"ENGINE": "django.db.backends.mysql",
"NAME": "mars-mgn",
"USER": "root",
"PASSWORD": "@d9Kf2!x",
"HOST": DATABASE_HOST,
"PORT": DATABASE_PORT,
"OPTIONS": {"init_command": "SET time_zone='+08:00'"},
}
}安装MySQL驱动
推荐使用mysqlclient驱动。
Windows开发环境安装mysqlclient驱动
pip install mysqlclientLinux生产环境安装mysqlclient驱动
# Debian / Ubuntu操作系统：
apt update
apt install python3-dev default-libmysqlclient-dev build-essential pkg-config
pip install mysqlclient
# Red Hat / CentOS操作系统：
sudo yum install python3-devel mysql-devel pkgconfig
pip install mysqlclient配置检查
下面命令检查你的项目配置是否符合规范，包括数据库连接。如果数据库配置错误或无法连接，会提示相关错误。
# 进入Django项目根目录（即包含manage.py的目录）
python manage.py check --database default排错指南
错误描述：启动Django项目时，提示如下
django.core.exceptions.ImproperlyConfigured: Error loading MySQLdb module.
Did you install mysqlclient?解决方法：尝试降低或升级mysqlclient版本。例如从2.2.4版本，降低到2.2.0版本。
[*]ubuntu22.04 + python3.9.20 + Django4.2.7 + mysqlclient2.2.0 测试成功
[*]ubuntu22.04 + python3.9.20 + Django4.2.7 + mysqlclient2.2.4 测试失败
pip show mysqlclient
pip install mysqlclient==2.2.0参考资料：mysqlclient 安装文档
二、数据库初始化
介绍
数据库初始化包括两部分
[*]生成数据库表
[*]向数据库表添加初始数据
生成数据库表
根据模型定义生成数据库迁移文件
python manage.py makemigrations执行数据库迁移，将迁移文件应用到数据库
python manage.py migrate向数据库表添加初始数据
在 Django 中，Fixtures 允许你将数据库中的数据导出，或加载到数据库中，通常用于测试、初始化数据库或迁移数据。
导出命令
[*]在应用APP下 ，创建 fixtures 目录，执行下面命令。其中，myapp 替换为实际的Django APP名称
# 进入Django项目根目录（包含manage.py的目录）
python manage.py dumpdata myapp --indent=2 > myapp/fixtures/myapp.json导入命令
# 进入Django项目根目录（包含manage.py的目录）
python manage.py loaddata myapp.json参考资料：Django 辅助工具
三、数据库初始化实战
实战场景
在Django后台管理项目中，myapp_system和myapp_infra是两个Django的应用。
[*]在项目开发时，向数据库添加了菜单、菜单权限、RBAC权限角色等初始化数据。如下图所示：
https://img2024.cnblogs.com/blog/1565852/202506/1565852-20250630170045745-728744509.png
[*]在项目生产部署时，需要将上述初始数据导入到生产环境的数据库。
导出数据
在开发环境，导出数据库步骤：
[*]在应用APP下 ，创建 fixtures 目录。myapp_system和myapp_infra是两个Django的应用，分别在其下创建 fixtures目录
[*]进入Django项目根目录（包含manage.py的目录），执行下面命令
# 分别导出`myapp_system`和`myapp_infra`是两个Django的应用的初始数据
python manage.py dumpdata myapp_system --indent=2 > myapp_system/fixtures/myapp_system.json
python manage.py dumpdata myapp_infra --indent=2 > myapp_infra/fixtures/myapp_infra.json
# 导出有集成其它第三方APP的初始数据
python manage.py dumpdata django_celery_beat --indent=2 > myapp_infra/fixtures/django_celery_beat.json
python manage.py dumpdata django_celery_results --indent=2 > myapp_infra/fixtures/django_celery_results.json
[*]转换格式：上述导出的文件格如果是UTF-16 LE编码，需要手动转换为UTF-8编码。
格式转换步骤：
[*]在 VS Code 中，打开上述导出的文件。查看右下角，显示的编码格式。
[*]点击右下角的这个编码格式——选择Save with Encoding——UTF-8
加载数据
项目生产部署时，向数据库导入初始数据
# 进入Django项目根目录（包含manage.py的目录），执行下面命令
# Django 会在每个安装的应用程序的 `fixtures` 目录中搜索
python manage.py loaddata myapp_system.json myapp_infra.json
python manage.py loaddata django_celery_beat.json django_celery_results.json数据导入后效果：
点击查看完整代码
您正在阅读的是《Django从入门到实战》专栏！关注不迷路~
来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！
页:
[1]