根本原因是Kratos请求生命周期与GORM事务管理未对齐:并发调用db.Transaction未控嵌套或超时,或中间件开事务未注入context,致repo层仍用主库查同一行而触发MySQL锁等待。

为什么 GORM 在 Kratos 里容易触发死锁?
根本原因不是 GORM 本身,而是 Kratos 的请求生命周期与 GORM 事务管理没对齐:多个 goroutine 并发调用同一 db.Transaction,但没控制嵌套层级或超时;或在中间件里开了事务,却没把 tx 注入 context,导致 repo 层仍用主库连接去查同一行——MySQL 就卡住。常见现象是接口偶发 5s+ 延迟,SHOW ENGINE INNODB STATUS 显示 WAITING FOR THIS LOCK TO BE GRANTED。
如何让 Transaction 真正绑定到单个 HTTP/gRPC 请求?
必须绕过手动传 tx 的写法,用 context 透传 + 私有 key 隔离。Kratos 没内置事务管理器,得自己补全这个链路:
-
data.go中定义私有 key:type ctxTxKey struct{},避免和其他包冲突 -
ExecTx方法里调用db.Transaction后,立刻用context.WithValue(ctx, ctxTxKey{}, tx)包一层再传给业务函数 -
DB(ctx context.Context)方法必须先检查ctx.Value(ctxTxKey{}),命中才返回事务 DB,否则回落到主库实例 - repo 方法统一调用
d.DB(ctx),禁止硬编码r.db.WithContext(ctx)
哪些 GORM 配置会放大死锁风险?
默认配置在高并发下很危险,尤其和 Kratos 的 middleware 链叠加时:
-
gorm.Config{SkipDefaultTransaction: true}必须设,否则每个Create/Save自动开事务,和显式Transaction嵌套就乱套 -
PrepareStmt: true要开,减少预处理语句重复编译,降低锁竞争 -
WriteTimeout和ReadTimeout必须设(如 3s),否则一个慢查询拖垮整个连接池 - MySQL 连接串加
timeout=3s&readTimeout=3s&writeTimeout=3s,和 GORM 层 timeout 对齐
怎么验证死锁是否真的被拦截住了?
光看日志不够,得从数据库侧确认事务隔离是否生效:
- 在 repo 方法开头加
log.Debugw("db source", "is_tx", ctx.Value(ctxTxKey{}) != nil),确认每次请求都走对了 DB 实例 - 用
SELECT * FROM information_schema.INNODB_TRX WHERE TIME_TO_SEC(NOW()) - TIME_TO_SEC(TRX_STARTED) > 2查超 2s 的活跃事务,上线后定期扫 - 压测时开启
log.Logger = logger.Default.LogMode(logger.Info),观察 SQL 日志里是否出现重复的START TRANSACTION或未配对的COMMIT/ROLLBACK
事务的上下文透传必须严格一对一,任何漏掉 ctx.Value 检查或 fallback 到主库的地方,都会让死锁在某个并发临界点突然爆发。


















