主从读写分离
读命令路由从库、写命令走主库——命令级换串、四档连串解析、故障转移横切、写后读粘性窗、只读档。 上位:总览。
架构:两缝正交
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); // 粘性窗长
});
路由语义(命令级)
- 路由点:
CommandCreating(命令已建、连接可换)——从库连接由路由器按目标池化复用。 - 命令类型判定:
CommandText首词分词(SELECT = 读;INSERT/UPDATE/DELETE/EXEC = 写);受管写 API(LoomUpdateAsync/LoomDeleteAsync/SaveChanges)强制主库,混合原生 SQL 同覆盖。 - 事务边界:上下文存在活动 DbTransaction / 环境事务 → 全量直通主库连接(路由关闭——一致性安全)。
- 粘性窗:写成功后短窗内读命令亦直通主库(AsyncLocal——写后读一致性的缺省保险)。
- 降级纪律:策略/解析抛错 → 回主库连接 + 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 日志。
机制边界
- 事务内不路由(一致性安全);2. 冻结模型兼容——路由发生在命令层,模型不变;3. AOT 兼容——首词分词 + 连接换挂均直接代码零反射;4. 单操作在途——DbContext 非线程安全既有语义下,命令级换连接无并发面。
反模式
| 症状 | 为什么错 | 正确形态 |
|---|---|---|
| 只读档写操作被抛 | 只读执法——误写从库的防误闸 | 写操作走主库上下文/受管写 API |
| 从库路由查询拿到旧数据(写后读) | 粘性窗未开或缺省窗内 | 粘性窗开关与窗口时长按业务一致性要求调 |
| 从库串全部失效后查询失败 | 未配回主库降级 | EnableFailover = true(缺省开)——全失效自动回主库 |
| 事务里期待读从库分摊压力 | 事务内强制主库(一致性安全,非 bug) | 长事务拆短;读压力在事务外消化 |
| 期望路由对模型有影响 | 路由在命令层——模型/冻结模型零关联 | 放心与 loom.CompiledModel 组合 |