dbresolver.Register必须在gorm.Open之后调用,否则插件不生效、读写分离失效;主从库需各自独立sql.Open并调优连接池参数,路由依据方法语义而非SQL解析,强一致读须显式标注Write。

dbresolver.Register 必须在 gorm.Open 之后调用
插件没注册成功,读写分离就根本不存在——db.Use(dbresolver.Register()) 放在 gorm.Open() 前,dbresolver 完全不会生效。GORM v2 要求插件必须绑定到已初始化的 *gorm.DB 实例上,否则所有 Find、First 都静默 fallback 到主库,日志里不报错也不提示。
正确顺序是:
db, err := gorm.Open(mysql.Open(dsnMaster), &gorm.Config{})- 紧接着立刻
db.Use(dbresolver.Register()) - 再配置
Sources和Replicas
漏掉 .Use() 这一步,整个配置就是“假分离”,压测时才发现读请求全打主库。
主库和每个从库必须各自 sql.Open,不能复用连接池
共用一个 *sql.DB 或浅拷贝配置指针,会导致连接池参数错乱、健康状态无法隔离、故障时互相拖累。MySQL 主库和从库是负载特征完全不同的服务端点,连接池参数必须独立调优。
推荐配置:
- 主库:
SetMaxOpenConns(50)、SetWriteTimeout(3 * time.Second)、SetConnMaxLifetime(5 * time.Minute) - 每个从库单独
sql.Open:SetMaxOpenConns(100)、SetReadTimeout(10 * time.Second)、SetConnMaxLifetime(10 * time.Minute) - 注册前务必对每个从库调用
slaveDB.Ping(),失败要记录告警——AddSlave或Replicas中地址不可达时不会报错,但后续读请求会静默 fallback 到主库
主从切换时连接池不会自动重连或迁移
GORM 的 dbresolver 不感知主库是否宕机,也不主动探测从库延迟。它只是按预设规则路由方法调用,不负责故障转移。
真实主从切换需额外闭环:
- 主库不可用时,不能把写请求转给某个从库——这是数据一致性灾难;应立即进入只读降级模式,并上报告警
- 从库复制延迟高(如
Seconds_Behind_Master > 30)时,dbresolver无原生检测能力,需自己查SHOW SLAVE STATUS并动态禁用该从库 - 切换决策应由独立的
failover-controllergoroutine 统一管理,通过 etcd watch 主库心跳,变更后更新共享的atomic.Value存储当前 master 地址
强一致读必须显式标注 Write,不能依赖 SQL 内容
GORM 不解析你写的 "SELECT ... FOR UPDATE" 或 "INSERT ... SELECT",它只看调用方式。默认规则简单粗暴,但容易踩坑:
-
Create/Save/Update/Delete/Begin→ 强制走Sources(主库) - 普通
Find/First/Where().Scan()→ 默认走Replicas(从库) - 事务内所有操作(包括
tx.First())强制走主库 - 强一致读(如支付扣款前查余额)必须显式走主库:
db.Clauses(dbresolver.Write).First(&u) - 带锁查询(
FOR UPDATE、LOCK IN SHARE MODE)必须加db.Session(&gorm.Session{Write: true}),否则从库拒绝执行
最常被忽略的是:Raw 查询默认走从库,但 db.Raw("SELECT * FROM users").Scan() 里若实际含写逻辑,就会在从库直接报错 ERROR 1290 (HY000): The MySQL server is running with the --read-only option。这类问题上线后才暴露,且难以复现。


















