Django结合MySQL主从架构实现读写分离完整指南
发布时间：2026-10-15| 4人浏览过
本文详细讲解如何利用Docker快速搭建MySQL主从环境，并通过Django的数据库路由机制实现读写分离。内容涵盖BinLog同步原理、Docker容器配置、用户授权及Slave状态检查，以及Django中手动指定库与自动路由器的具体代码实现，帮助开发者提升数据库并发处理能力。
一、MySQL主从搭建
主从配置原理：
- 主库将数据变更写入二进制日志（BinLog）
- 从库启动一个IO线程，读取主库的BinLog日志，并将其写入本地的中继日志（RelayLog）
- 随后，从库启动另一个SQL线程，读取RelayLog日志并在从库中执行回放，从而保持数据同步
主从配置流程：
- Master服务器将数据变动记录到二进制日志中
- Master服务器开启一个IO线程，负责将二进制日志发送给Slave服务器
- Slave服务器开启一个IO线程，接收Master发送的二进制日志，并将其写入到本地的Relay日志中
- Slave服务器开启一个SQL线程，读取Relay日志中的指令，并在Slave数据库中执行，完成数据同步
操作步骤
使用Docker模拟两台MySQL数据库服务器
1、修改配置文件：
主库的配置文件
[mysqld]
user=mysql
character-set-server=utf8
default_authentication_plugin=mysql_native_password
secure_file_priv=/var/lib/mysql
expire_logs_days=7
sql_mode=STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION
max_connections=1000
server-id=100 # 主库，同一局域网内注意要唯一
log-bin=mysql-bin # 开启二进制日志功能，可以随便取名字（二进制文件名）
[client]
default-character-set=utf8
[mysql]
default-character-set=utf8从库的配置文件
[mysqld]
user=mysql
character-set-server=utf8
default_authentication_plugin=mysql_native_password
secure_file_priv=/var/lib/mysql
expire_logs_days=7
sql_mode=STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION
max_connections=1000
server-id=101 # 从库设置server_id,注意要唯一
log-bin=mysql-slave-bin # 开启二进制日志功能，定义名字，以备Slave作为其它Slave的Master时使用
relay_log=edu-mysql-relay-bin # relay_log配置中继日志
[client]
default-character-set=utf8
[mysql]
default-character-set=utf8
启动Docker容器
#启动主库容器（挂载外部目录，端口映射成33307，密码设置为123456）
docker run -di -v /home/mysql/data/:/var/lib/mysql -v /home/mysql/conf.d:/etc/mysql/conf.d -v /home/mysql/my.cnf:/etc/mysql/my.cnf -p 33307:3306 --name mysql-master -e MYSQL_ROOT_PASSWORD=123456 mysql:5.7
#启动从库容器（挂载外部目录，端口映射成33306，密码设置为123456）
docker run -di -v /home/mysql2/data/:/var/lib/mysql -v /home/mysql2/conf.d:/etc/mysql/conf.d -v /home/mysql2/my.cnf:/etc/mysql/my.cnf -p 33306:3306 --name mysql-slave -e MYSQL_ROOT_PASSWORD=123456 mysql:5.7
2、由于主库和从库都需要对日志文件进行操作，这需要创建一个专用用户来执行同步任务，因此主库和从库都需要创建该用户
# 连接库
mysql -h 192.168.88.131 -P 33307 -u root -p123456
# 在主库创建用户并授权
# 创建test用户
create user 'test' identified by '123';
# 授权用户
grant all privileges on *.* to 'test' ;
# 刷新权限
flush privileges;
3、连接从库进行同步配置
# 连接从库
mysql -h 192.168.88.131 -P 33306 -u root -p123456
# 命令如下
change master to master_host='192.168.88.131',master_port=33307,master_user='test',master_password='123',master_log_file='mysql-bin.000003',master_log_pos=0;
# 启用从库
start slave;
# 停止从库
stop slave;
# 查看从库状态
show slave status\G;
# 这两个yes表示匹配成功
-Slave_IO_Running: Yes
-Slave_SQL_Running: Yes
# 配置详解
change master to
master_host='MySQL主服务器IP地址',
master_user='之前在MySQL主服务器上面创建的用户名'，
master_password='之前创建的密码',
master_log_file='MySQL主服务器状态中的二进制文件名', # show master status; 查看
master_log_pos='MySQL主服务器状态中的position值'; # show master status; 查看二、Django实现读写分离
首先确保MySQL主从环境搭建完成：
在Django的settings.py中配置数据库连接信息
DATABASES = {
# 主库
'default': {
'ENGINE': 'django.db.backends.mysql',
'NAME': 'test',
'USER': 'root',
'PASSWORD': '123456',
'HOST': '192.168.88.131',
'PORT': 33307,
},
# 从库
'slave': {
'ENGINE': 'django.db.backends.mysql',
'NAME': 'test',
'USER': 'root',
'PASSWORD': '123456',
'HOST': '192.168.88.131',
'PORT': 33306,
},
}
在进行数据库迁移时，可以指定将特定App的表结构迁移到指定的数据库中
python manage.py migrate app01 --database=default
手动指定数据库
# 去default库写——>主库
content = models.User.objects.using('default').create(name='小杨', age='20')
# 去slave库查——>从库
content = models.User.objects.using('slave').all().first()
自动指定数据库
1、新建一个Python文件
db_router.py
class Router:
def db_for_read(self, model, **hints):
return 'slave'
def db_for_write(self, mode, **hints):
return 'default'
# 更细粒度
class Router1:
def db_for_read(self, model, **hints):
if model._meta.model_name == 'user': # 只有User表才会去从库读
return 'slave'
else:
return 'default'
def db_for_write(self, model, **hints):
return 'default'
2、在settings.py中注册路由配置
DATABASE_ROUTERS = ['db_router.Router',]
# 以后只要是写操作就会用default，只要是读操作自动去slave
到此这篇关于Django搭建MySQL主从实现读写分离的文章就介绍到这了,更多相关Django MySQL读写分离内容请搜索本站以前的文章或继续浏览下面的相关文章希望大家以后多多支持本站！
免责声明：本文内容仅供参考，不代表本站观点。转载或引用请注明出处。
