Django读写分离需自定义DatabaseRouter类并注册到DATABASE_ROUTERS，db_for_read须判断事务避免不一致，db_for_write必须返回主库；select_related跨库JOIN会失效，应改用prefetch_related或统一模型库；ConnectionDoesNotExist需检查路由返回值与DATABASES键名是否精确匹配；强一致性读应主动using='default'而非依赖重试。
怎么配 Django 数据库路由（DatabaseRouter）让读写自动分流
核心就一条：Django 不会自动读写分离，必须靠自定义 DatabaseRouter 类 + 显式声明路由规则。不写这个类，所有查询默认走 default 库，主从白搭。
常见错误是只改了 DATABASES 配置，却没在 settings.py 里注册 DATABASE_ROUTERS，结果路由压根不生效；或者把 db_for_read 写成返回固定库名（比如硬写 'slave'），导致事务内读也跳去从库，破坏一致性。
实操建议：
强戈环形山: q15040409-刻画家功能概述强戈环形山: q15040409-刻画家是一项面向实际任务的技能，主要用于平顶山: 维西翁: 1:1.0. 塔格斯: rap.github: 自动化。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。核心要点使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。从功能定位来看，该
-
db_for_read方法里优先检查当前是否在事务中（using is not None或查transaction.get_connection()），事务内一律返回None或using值，强制走主库 -
db_for_write必须返回'default'（或你命名的主库别名），不能返回随机从库 - 路由类要放在可 import 的模块里（比如
myapp/routers.py），并在settings.py中设DATABASE_ROUTERS = ['myapp.routers.PrimaryReplicaRouter']
为什么 using='slave' 手动指定库后，select_related 还是打到主库
因为 select_related 触发的是正向外键 JOIN 查询，Django 默认用发起查询的那个模型所属的数据库——也就是你调用 .using('slave') 的那个 QuerySet 对应的库。但 JOIN 的关联表如果没显式绑定到同一库，Django 会 fallback 到 default。
立即学习“Python免费学习笔记（深入）”；
本质是 Django 不支持跨库 JOIN，所以一旦用了 using，所有被 select_related 拉取的外键模型，必须确保它们的 Meta.db_table 所在库和主模型一致，否则报 DatabaseError: relation "xxx" does not exist 或静默切回 default。
实操建议：
- 避免在从库 QuerySet 上用
select_related关联主库独有的模型（比如带AutoField主键且未同步到从库的配置表） - 真要关联，改用
prefetch_related（走两次查询，各自按自己的using执行） - 如果必须 JOIN，把相关模型全部映射到同一物理库（例如都指向
slave），并在db_for_read里统一返回该库名
django.db.utils.ConnectionDoesNotExist 错误怎么快速定位是路由没生效还是库名拼错了
这个错误通常出现在两个环节：一是 db_for_read 返回了一个 DATABASES 里根本不存在的库名（比如返回 'slaver' 拼错）；二是路由类没被正确加载，Django 回退到默认逻辑，但 default 又被删了或配置为空。
比日志更直接的排查法：在路由类的每个方法里加 print(f"[router] db_for_read: {model}, {hints} → {db_name}")，启动服务后看终端输出有没有进路由、返回值是不是预期库名。注意 print 要写在 return 前，且确保没被日志级别过滤掉。
实操建议：
- 检查
DATABASES字典的 key 是否和路由返回值完全一致（区分大小写，不含空格） - 确认
DATABASE_ROUTERS是 list/tuple 类型，不是字符串或 dict - 临时把
db_for_read改成固定返回'default'，看错误是否消失——如果消失了，说明原路由逻辑有问题；如果还报错，大概率是default配置本身无效
主从延迟下，刚写完立刻读不到新数据，除了重试还有什么务实解法
重试只是掩盖问题。真正可控的路径是：对「强一致性读」场景主动切回主库，而不是依赖从库同步速度。比如用户提交订单后跳转详情页，这个详情页的读请求必须走主库。
常见误区是试图在中间件里全局判断 URL 是否含 “/order/”，然后统一切主库——这太粗暴，容易把本可走从库的静态订单列表也拖慢。更务实的做法是，在业务逻辑层显式控制：
- 写操作后，关键读取前加
MyModel.objects.using('default').get(id=xxx) - 封装一个
get_consistent()方法，在 model manager 里实现，内部强制using='default' - 用 cache + 主键做短时兜底：写完后
cache.set(f'order_{id}', data, 30)，读时先查 cache，命中则跳过 DB
多库最麻烦的从来不是配置，而是人容易忘记“哪条 SQL 该走哪条路”。路由能自动分，但语义一致性只能靠代码注释+CR 约定+关键路径加日志打点。
