事务内读不到刚写数据,根本原因是未从主库实例显式Begin(),且混用了全局db的Find()等方法;正确做法是用masterDB.Begin()获取tx,并全程复用tx对象执行查询。

主从延迟下事务内读不到刚写的数据,不是 GORM 没配好,而是你调用了错误的 DB 实例或没控制好路由起点——事务必须从主库 Begin() 开始,且后续所有操作必须复用该事务对象,不能混用全局 db 的 Find() 或 First()。
事务必须基于主库实例启动,不能走 dbresolver 包装后的 db
这是最常被忽略的起点错误。GORM 的 dbresolver 会把 db.Begin() 自动路由到主库,但前提是这个 db 是你注册进 resolver 的主库源(Sources),而不是 resolver 包装后的多数据源实例。
- ❌ 错误写法:
db.Begin(),其中db是dbresolver.Register(...)返回的包装实例 —— 它可能 fallback、可能选错源,行为不可控 - ✅ 正确写法:显式用主库
*gorm.DB实例调用masterDB.Begin(),再把tx传给业务逻辑 - ⚠️ 注意:
tx是独立连接上下文,它不继承 resolver 路由规则;tx.First()和tx.Where().Find()都天然走主库,无需加.Clauses(dbresolver.Write)
事务内禁止调用全局 db 的读方法
封装好的 DAO 方法如果内部用了全局 db.Find(),在事务中直接调用就会静默发往从库,破坏事务隔离性,且不报错。
- ❌ 危险模式:
tx := masterDB.Begin(); defer tx.Commit(); user, _ := GetUserByID(123) // 内部用的是 db.Find() → 从库执行 - ✅ 安全做法:DAO 方法接受
*gorm.DB参数,调用方传入tx:GetUserByID(tx, 123) - ? 补救方案:若无法改 DAO,可在事务内用
tx.Session(&gorm.Session{Write: true})强制锁定写上下文,但不如直接传参干净
强一致读不能依赖“写后立即查”,必须显式切主库
刚 Create() 完立刻 db.First(),哪怕不在事务里,也大概率读不到——因为从库还没同步。GORM 不等、不重试、不感知延迟。
- ✅ 立即查新数据:用
db.Clauses(dbresolver.Write).Where("id = ?", id).First(&u) - ✅ 或更明确:
masterDB.Where("id = ?", id).First(&u)(直接用主库实例) - ⚠️ 注意:
db.Session(&gorm.Session{Write: true}).First()必须放在链式调用最开头,Where().Session().First()无效 - ? 场景判断:订单创建后跳转详情页,建议返回 ID,前端用 ID 发起新请求,并在接口层识别该 ID 属于“刚写入”范围,自动路由主库
从库延迟超阈值时,别等它,要熔断
GORM 本身完全不感知 Seconds_Behind_Master,也不会因从库慢而自动降级。业务层必须自己轮询并做决策。
- ✅ 启动时或定时任务中,对每个从库执行
slaveDB.Raw("SHOW SLAVE STATUS").Scan(&row),提取Seconds_Behind_Master - ✅ 延迟 > 5s 时,从负载列表中临时剔除该从库,后续读请求 fallback 到主库(或剩余健康从库)
- ⚠️ 关键细节:
AddSlave()失败不 panic,日志只输出 debug 级别信息,极易被忽略;务必在启动后主动slaveDB.Ping()并记录告警 - ? 性能提示:从库连接池参数需单独调优,
SetMaxOpenConns(100)+SetReadTimeout(5 * time.Second),避免 goroutine 卡死
事务一致性真正的破局点不在 ORM 配置,而在调用链起点是否可控、DAO 接口是否接收事务对象、以及强读场景是否被明确标注和路由——这些地方一旦松动,再多的 Clauses 和 Session 都只是补丁。


















