事务耗时监控不能靠db.Transaction外层打点,必须进入GORM trace生命周期,在事务级context中埋点;GORM v1.20+支持context透传至Trace(),需手动注入txStartTimeKey并全程透传,否则漏计锁等待、网络延迟等关键环节。

事务耗时监控不能靠 db.Transaction 外层打点
直接在 db.Transaction 调用前后用 time.Now() 计时是错的。因为 db.Transaction 只是启动回调函数,真正执行 SQL 的是内部 tx 对象,且事务可能包含多次查询、SavePoint 分支、甚至跨 goroutine 的异步操作。外层计时会漏掉连接获取、锁等待、网络往返等关键延迟,数值严重偏低。
正确路径只有一条:必须进入 GORM 的 trace 生命周期,在事务级上下文里埋点。GORM v1.20+ 已将 context.Context 透传到 Trace() 方法中,这是唯一能绑定“本次事务全程”的载体。
- 不要试图用全局 map 存开始时间——并发下 key 冲突、内存泄漏、goroutine 错配全都会发生
- 不要复用默认 logger 的
Info()或Warn()——它们只在 SQL 执行完才触发,拿不到事务开启时刻 - 事务耗时 ≠ SQL 耗时总和,中间可能有 Go 层逻辑、外部 API 调用、锁等待,这些必须由你显式包裹
自定义 Logger 必须覆盖 Trace() 并注入 context
核心不是重写整个 gorm.Logger 接口,而是嵌套默认 logger 并只重写 Trace()。重点是在 Begin 阶段把起始时间塞进 ctx,在 End 阶段取出计算差值:
func (l *TxLogger) Trace(ctx context.Context, begin time.Time, fc func() (string, int64), err error) {
// 从 ctx 中取事务开始时间(需在 Begin 时存入)
if txStart, ok := ctx.Value(txStartTimeKey).(time.Time); ok {
elapsed := time.Since(txStart)
if elapsed > l.slowThreshold {
log.Printf("[TX SLOW] %v | %s", elapsed, fc())
}
}
}
-
txStartTimeKey是自定义struct{}类型,避免 context key 冲突 - 必须在事务
Begin后立刻调用context.WithValue(ctx, txStartTimeKey, time.Now()),这个ctx要一路透传给所有后续tx操作 -
fc()闭包要能返回可识别的事务标识,比如 SQL 第一条语句 + 参数摘要,而不是空字符串
事务开启时必须手动注入计时上下文
GORM 不会自动给你塞 context.WithValue,这一步必须由你控制。有两种安全做法:
- 用
db.WithContext(ctx)包一层再传入Transaction()回调,然后在回调开头立即存时间:txCtx := context.WithValue(ctx, txStartTimeKey, time.Now()) - 若用
db.Begin()手动事务,则在tx := db.Begin()后马上做tx = tx.WithContext(context.WithValue(context.Background(), txStartTimeKey, time.Now())) - 绝对不要用
time.Now()直接算差值——Trace()的begin参数是 ORM 解析完成时间,不是事务开启时间,二者可能差几十毫秒
注意:db.Transaction() 内部会新建一个 *gorm.DB 实例,它不继承外层 ctx,所以必须显式传入或重置。
上线后日志没出来?先查这三处
不是代码没生效,大概率卡在配置链路里:
-
SlowThreshold设太高(比如5s),而实际事务多在800ms完成,永远不触发 -
LogLevel没设成logger.Info或更高,Trace()根本不会被调用 - 事务里混用了未带上下文的
db实例(比如误调db.Create()而非tx.Create()),这部分操作完全脱离你的监控 scope
最隐蔽的坑是:MySQL 在事务中执行 CREATE TABLE 等 DDL 会隐式提交,导致后续 Trace() 收到的其实是新事务的 begin,时间戳错乱。这类操作必须单独剥离出事务体。











