Table of Contents

主从读写分离

读命令路由从库、写命令走主库——命令级换串、四档连串解析、故障转移横切、写后读粘性窗、只读档。 上位:总览。

架构:两缝正交

LoomReadConnectionStringProvider   ← 连串解析 SPI(从库串从哪来——解析与决策正交)
        │ 四档内置解析全部落码(纯算法纯配置零外部依赖);SPI 仅保留给动态源场景
        ▼
IDbCommandInterceptor.CommandCreating ← 路由执行点(有命令、可换 command.Connection)

路由器按候选串序列依次取连接——故障转移横切对全部解析档生效(横切在路由器层,不在解析实现内)。

连串解析:四档内置

档(LoomReadProviderKind) 语义 配置
Fixed(缺省) 单从库串——所有读路由该串 ReadConnectionStrings = ["r1"]
RoundRobin 均匀轮询(Interlocked 递增取模——零锁均匀) 串集 ≥2
Weighted 加权分摊(平滑加权轮询——Nginx 同款平滑算法) Weights = [3, 1](缺省均等)
Failover 有序主选——按串序固定优先(r1 健康期内全走 r1) 串集按优先级排序

SPI 仅保留给动态源场景(配置中心热更推送从库列表等):继承 LoomReadConnectionStringProvider 实现 Produce()(候选序列语义,首选在前)——故障转移横切自动生效。

装配与选项

services.AddLoomEf<OrderCtx>(o => o.UseSqlServer(masterCs), loom =>
{
    loom.ReadSplit.Enabled = true;
    loom.ReadSplit.Provider = LoomReadProviderKind.Weighted;              // 四档内置 or SPI 子类实例
    loom.ReadSplit.ReadConnectionStrings = ["cs-r1", "cs-r2"];
    loom.ReadSplit.Weights = [3, 1];                                      // Weighted 档(缺省均等)
    loom.ReadSplit.EnableFailover = true;                                 // 缺省开
    loom.ReadSplit.FailoverCooldown = TimeSpan.FromSeconds(30);           // 失败冷却窗
    loom.ReadSplit.StickyEnabled = true;                                  // 写后读粘性(缺省开)
    loom.ReadSplit.StickyWindow = TimeSpan.FromSeconds(10);               // 粘性窗长
});

路由语义(命令级)

  1. 路由点:CommandCreating(命令已建、连接可换)——从库连接由路由器按目标池化复用。
  2. 命令类型判定:CommandText 首词分词(SELECT = 读;INSERT/UPDATE/DELETE/EXEC = 写);受管写 API(LoomUpdateAsync/LoomDeleteAsync/SaveChanges)强制主库,混合原生 SQL 同覆盖。
  3. 事务边界:上下文存在活动 DbTransaction / 环境事务 → 全量直通主库连接(路由关闭——一致性安全)。
  4. 粘性窗:写成功后短窗内读命令亦直通主库(AsyncLocal——写后读一致性的缺省保险)。
  5. 降级纪律:策略/解析抛错 → 回主库连接 + Warn 观测——路由故障永不阻塞写路径。

故障转移横切

解析档产出候选串序列 → 路由器按序尝试取连接;连接失败/超时 → 该串进入冷却窗(缺省 30s 内跳过,窗满自动恢复——半开重试);候选全部失效 → 回主库降级 + Warn 观测。健康探测 = 被动(连接失败即信号——零探测线程零外部依赖),主动探活为可选增强缺省关。

只读档(DualContext 强隔离形态)

读写双上下文(同实体 n:n 多绑定,见声明与模型构建)+ 读上下文只读执法:

[EfEntity(typeof(WriteCtx), ...)] public sealed class Order { ... }
[EfEntity(typeof(ReadCtx), ...)]  public sealed class Order { ... }   // 同实体双绑定

services.AddLoomEf<ReadCtx>(o => o.UseSqlServer(readCs),
    loom => loom.ReadSplit.ReadOnly = true);   // 该上下文 SaveChanges/受管写 API/受管批写全 Throw 指路写上下文

写上下文保存成功 → 粘性窗置位 → 窗内读上下文查询路由主库。

观测

loom_ef_readsplit_route_total(路由次数)/ loom_ef_readsplit_hit_total(命中从库)——降级与粘性命中走 Warn/Debug 日志。

机制边界

  1. 事务内不路由(一致性安全);2. 冻结模型兼容——路由发生在命令层,模型不变;3. AOT 兼容——首词分词 + 连接换挂均直接代码零反射;4. 单操作在途——DbContext 非线程安全既有语义下,命令级换连接无并发面。

反模式

症状 为什么错 正确形态
只读档写操作被抛 只读执法——误写从库的防误闸 写操作走主库上下文/受管写 API
从库路由查询拿到旧数据(写后读) 粘性窗未开或缺省窗内 粘性窗开关与窗口时长按业务一致性要求调
从库串全部失效后查询失败 未配回主库降级 EnableFailover = true(缺省开)——全失效自动回主库
事务里期待读从库分摊压力 事务内强制主库(一致性安全,非 bug) 长事务拆短;读压力在事务外消化
期望路由对模型有影响 路由在命令层——模型/冻结模型零关联 放心与 loom.CompiledModel 组合

想深入