当前位置：首页 > 文章列表 > Golang > Go教程 > Go Flight Recorder 实战：线上偶发卡顿，别再只靠日志碰运气

Go Flight Recorder 实战：线上偶发卡顿，别再只靠日志碰运气

来源：Go 官方博客参考，17golang 原创解读 2026-06-01 17:58:16 0浏览收藏

线上服务最讨厌的一类问题，不是每分钟都慢，而是偶尔卡一下。日志看起来一切正常，pprof 抓到的时候现场已经没了，等你想开 trace，事情早就过去了。Go 1.25 里的 Flight Recorder，解决的就是这个“案发现场留不住”的问题。

这篇我不写成发布说明翻译。我们站在后端服务排障视角聊：Flight Recorder 适合抓什么问题，怎么设置触发条件，怎么控制内存和文件大小，最后怎么用 go tool trace 找到真正卡住的 goroutine。

Go Flight Recorder 线上诊断思维导图 — 思维导图：Flight Recorder 更像一段可回放的现场记录，适合捕捉慢请求、健康检查抖动和偶发调度停顿。

为什么光靠日志和 pprof 不够

日志回答的是“发生了什么业务事件”，pprof 更擅长回答“谁在消耗 CPU、内存、锁等待”。但偶发慢请求还有一个问题：你需要知道慢之前那几秒，goroutine 到底在运行、等待、唤醒还是被别的锁挡住。

普通 execution trace 很强，但长时间 Web 服务不可能从启动开始一直完整采集。数据量会很大，存储和分析成本也高。Flight Recorder 的思路更务实：在内存里滚动保存最近一小段 trace，只有当程序发现异常时才把这段现场快照写出来。

我会在哪些场景考虑它

第一类是慢请求：比如大部分请求 5ms，偶尔跳到 300ms，而且 pprof 看不到稳定热点。第二类是健康检查偶发超时：服务没挂，但调度或锁竞争短暂异常。第三类是后台任务把前台请求拖慢：比如统计任务、批量 flush、定时上报和主链路抢同一把锁。

这些问题有一个共同点：等你 SSH 上去再开工具，现场往往已经消失。Flight Recorder 的价值就是把“触发异常前的几秒”留下来。

Go Flight Recorder 排障流程图 — 流程图：先定义异常条件，再滚动保留 trace，触发后落盘，最后用 trace 时间线追 goroutine 的等待关系。

一个生产里更像样的接入方式

不要一上来就把所有请求都写 trace 文件。我的习惯是先定义触发条件，比如请求耗时超过 200ms，或者健康检查连续两次超过阈值。真正触发时只抓一次，避免故障期间疯狂写文件。

type Recorder struct {
    fr   *trace.FlightRecorder
    once sync.Once
}

func NewRecorder() *Recorder {
    fr := trace.NewFlightRecorder(trace.FlightRecorderConfig{
        MinAge:   2 * time.Second,
        MaxBytes: 32 << 20,
    })
    fr.Start()
    return &Recorder{fr: fr}
}

func (r *Recorder) CaptureIfSlow(cost time.Duration) {
    if cost < 200*time.Millisecond || !r.fr.Enabled() {
        return
    }
    r.once.Do(func() {
        go func() {
            f, err := os.Create("slow-request.trace")
            if err != nil {
                slog.Warn("create trace failed", "err", err)
                return
            }
            defer f.Close()
            if _, err := r.fr.WriteTo(f); err != nil {
                slog.Warn("write trace failed", "err", err)
                return
            }
            r.fr.Stop()
        }()
    })
}

这里有几个细节别省：once 是为了防止大量慢请求同时触发；MaxBytes 是为了保护内存；写文件最好放到 goroutine 里，不要让慢请求在返回前继续背锅。