Go 1.27 pprof Web UI 默认火焰图视图怎么切回图形视图

如果你升级到 Go 1.27 后运行 go tool pprof -http=:6060 profile.pb.gz，打开根地址直接看到火焰图，不代表 Graph 被移除了。Go 1.27 分支内置的 pprof Web UI 把默认入口落到了 /ui/flamegraph，图形视图仍可从顶部的 View → Graph 进入，也可以把地址改成 /ui/graph。

想恢复旧的调用关系图，优先点击 View → Graph；脚本化或书签场景直接使用 http://localhost:6060/ui/graph。两种视图读取的是同一份 profile，只是关注点不同。

默认为什么落到火焰图

pprof 的 Web UI 不是只提供一种图。Go 的诊断文档把 text、graph、callgrind 和 flame graph 都列为 profile 的可视化方式；其中火焰图适合沿特定调用栈路径放大和缩小。变化发生在入口选择：Go 1.27 分支 vendored 的 Web UI 代码将内部根路径重定向到 flamegraph，所以用户从根地址进入时先看到的是火焰图。

这个现象容易被误读成“Graph 不见了”。实际上，源码仍注册了 /graph 和 /flamegraph 两个 handler，外层的本地 UI 路径是 /ui/。因此，真正变化的是默认落点，而不是图形视图的能力。

用 View 菜单切回 Graph

先用原来的方式启动 Web UI。下面的命令只负责打开本地服务，不会改变 profile 内容。

# 使用已有的 profile 文件启动本地 pprof Web UI
go tool pprof -http=:6060 profile.pb.gz

浏览器打开后，如果当前地址类似 http://localhost:6060/ui/flamegraph，点击顶部 View，再选择 Graph。切换成功后，页面会展示函数节点、节点之间的调用方向以及对应的 flat/cumulative 关系。

如果你是从 HTTP profile 地址启动，入口写法也不变：

# 从本地 net/http/pprof 端点采集 30 秒 CPU profile 并打开 UI
go tool pprof -http=:6060 'http://127.0.0.1:6061/debug/pprof/profile?seconds=30'

这里的 6060 是 pprof UI 监听端口，6061 是被分析服务的端口；两者可以不同。菜单切换只改变当前展示路径，不会重新采集数据。

地址栏怎么直接打开图形视图

需要固定书签、自动化打开或菜单加载异常时，直接把路径改成：

# 浏览器地址栏中的本地图形视图路径
http://localhost:6060/ui/graph

如果端口或主机不是默认值，保留前面的主机和端口，只替换路径。例如当前地址是 http://127.0.0.1:7070/ui/flamegraph，就改为 http://127.0.0.1:7070/ui/graph。要回到火焰图，则将最后一段换回 /ui/flamegraph。

Graph 和 Flame graph 分别看什么

不要把“切回 Graph”理解成更老、更正确的模式。Graph 把函数作为节点，用边表示 caller/callee 关系，适合回答“谁调用了这个函数”“热点从哪条调用链进入”。如果节点很多，拖动和缩放能帮助你沿关系网定位。

Flame graph 则把调用栈按层级排开。框越宽，表示包含该栈帧的样本值越多；宽度不是函数源码行数，也不是单次调用耗时。它更适合先从宽路径找到高占比栈，再逐层放大。两者只是同一份 profile 的不同投影，切换视图不会让 CPU、heap 或 goroutine 采样重新计算。

常见问题

Go 1.26 打开根地址也会进入火焰图吗？

不要只按版本号猜测。这个入口取决于实际运行的 go tool pprof 及其内置 pprof 代码；遇到不同机器表现不一致时，直接看当前地址并尝试 /ui/graph。

切换到 Graph 会重新采集 CPU profile 吗？

不会。菜单和 URL 只是在同一份 profile 上切换报告视图；只有再次访问采集端点或重新执行采集命令，才会产生新的采样过程。

Graph 页面打不开通常先查什么？

先确认 UI 端口、主机名和完整的 /ui/graph 路径，再确认启动命令使用的是目标 Go 版本。若图形渲染报 Graphviz 相关错误，那是渲染依赖问题，不等于 Graph 路由被删除。