必须在settings.py的DATABASES字典中为每个数据库定义唯一别名(如'default'、'replica1'),'default'必须存在且不可删除;各数据库ENGINE可不同,但跨引擎事务会失败;连接参数须显式配置,未声明字段(如READ_ONLY)会被Django忽略。

如何在 Django 的 DATABASES 配置中定义多个数据库?
必须手动在 settings.py 的 DATABASES 字典里为每个数据库起一个唯一别名(如 'default'、'replica1'、'analytics'),不能只靠环境变量动态覆盖键名。Django 不会自动识别“主库/从库”语义,所有别名地位平等,后续路由逻辑全靠你控制。
常见错误是把多个 MySQL 实例配成同名 'default',结果只有最后一个生效;或误以为加了 READ_ONLY=True 这类自定义字段就能触发读写分离——Django 完全忽略未声明的配置项。
-
'default'必须存在,哪怕你从不直接用它,Django 迁移、管理命令默认都走这个别名 - 各数据库的
ENGINE可以不同(比如django.db.backends.postgresql和django.db.backends.mysql混用),但跨引擎的事务、关联查询会失败 - 连接参数如
HOST、PORT、NAME必须显式写出,环境变量需用os.getenv()提前解析,不能留空字符串
如何让 QuerySet 自动走指定数据库(比如读走 replica1)?
Django 没有内置“读写分离中间件”,得靠 .using() 或数据库路由(DatabaseRouter)硬编码分流。直接调 MyModel.objects.using('replica1').all() 最简单,适合明确知道该读哪台的场景;但一旦漏写,就会 fallback 到 default,可能把读压力压到主库。
更稳妥的是实现 db_router.py 并在 settings.py 中注册 DATABASE_ROUTERS = ['myapp.db_router.ReplicaRouter']。路由类要重写 db_for_read() 和 db_for_write() 方法,返回具体别名。
立即学习“Python免费学习笔记(深入)”;
-
db_for_read()可按模型名判断:对Report类模型固定返回'analytics',对其他模型轮询['replica1', 'replica2'] -
db_for_write()通常只返回'default',但注意save(using='...')会绕过路由,直接命中指定库 - 路由方法里不能做耗时操作(如查缓存、发 HTTP 请求),否则拖慢所有 DB 查询
使用 transaction.atomic() 时为什么报 TransactionManagementError: Transaction managed by another database?
因为 Django 的事务绑定在单个数据库连接上,跨库操作(比如在 default 写、同时在 replica1 读)无法纳入同一事务。即使你没显式调 .using(),只要 atomic() 块里触发了任何数据库操作,Django 就会锁定当前线程的默认连接。
典型踩坑:在事务里调用了某个封装了 .using('replica1') 的统计函数,结果主库事务还在跑,从库查询却试图复用同一个连接池——Django 直接抛错。
- 解决办法只有两个:要么把所有操作收敛到同一数据库(牺牲读写分离),要么拆开事务,用最终一致性代替强一致
-
select_for_update()必须和写操作在同一库,否则锁无效;且不能在replica库上调用,会报OperationalError - 测试时容易忽略:Django 的
TestCase默认用default库的事务回滚机制,若测试涉及多库,得自己用TransactionTestCase并手动清理
为什么从库查询偶尔返回旧数据(stale read)?
这不是 Django 的问题,而是底层数据库主从延迟导致的。Django 发送的 SELECT 语句本身没有“强制同步”语义,MySQL/PostgreSQL 的复制延迟可能达几百毫秒。如果你在主库 save() 后立刻去从库查,大概率查不到刚写的记录。
缓解手段有限:应用层可加短延迟(不推荐)、用主库查关键路径(如订单创建后立即查详情)、或依赖数据库自身的强同步选项(如 MySQL 5.7+ 的 AFTER_SYNC 复制模式)。
- Django 的
slave/master别名只是你起的名字,不代表自动启用半同步复制 - 不要在
db_for_read()里加健康检查(如 ping 主机),这会让每次查询多一次网络往返,放大延迟 - 真正需要强一致的场景(如金融类操作),应放弃读写分离,所有读写都走主库
MAX_CONNS、CONN_MAX_AGE)往往比代码更难调——主库连接数打满、从库连接泄漏、复制延迟突增,这些问题不会在本地开发环境暴露。


















