Go pprof 性能分析工具

Sun, 15 Jun 2025 16:36:21 +0800

Go pprof 性能分析工具指南

1. 概述

本文档系统介绍了 Go 语言中 pprof 性能分析工具的使用方法，重点分析不同 profiling 工具（goroutine、profile、heap 等）的适用场景，帮助开发者针对性地选择性能分析工具。

2. 各工具使用场景

2.1 Goroutine 分析

适用场景

goroutine 泄漏检测：程序运行中 goroutine 数量持续增长不下降
阻塞问题排查：怀疑存在 goroutine 阻塞或死锁问题
并发模型分析：需要了解程序并发模型和 goroutine 分布情况
高并发调优：高并发场景下的性能问题排查

代码示例：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65


package main

import (
	"fmt"
	"net/http"
	_ "net/http/pprof"
	"sync"
	"time"
)

func main() {
	// 启动 pprof 服务
	go func() {
		fmt.Println("pprof 服务地址: http://localhost:6060/debug/pprof")
		http.ListenAndServe("localhost:6060", nil)
	}()

	// 场景1: channel 接收阻塞
	ch1 := make(chan int)
	go func() {
		fmt.Println("channel 阻塞 goroutine 启动")
		<-ch1 // 永久阻塞
	}()

	go func() {
		time.Sleep(2 * time.Minute)
		fmt.Println("2分钟后解除 channel 阻塞")
		ch1 <- 1
	}()

	// 场景2: select 多路等待
	go func() {
		ch1 := make(chan int)
		ch2 := make(chan int)

		fmt.Println("select 多路等待 goroutine 启动")
		select {
		case <-ch1:
		case <-ch2:
		}
	}()

	// 场景3: 锁竞争
	go func() {
		var mu sync.Mutex
		mu.Lock() // 获取锁

		go func() {
			time.Sleep(time.Minute)
			fmt.Println("1分钟后解锁")
			mu.Unlock()
		}()
		
		fmt.Println("锁竞争 goroutine 启动")
		mu.Lock() // 再次获取锁导致阻塞
	}()

	fmt.Println("程序运行中，查看 goroutine 状态方法:")
	fmt.Println("1. 浏览器访问: http://localhost:6060/debug/pprof/goroutine?debug=1")
	fmt.Println("2. 命令行: go tool pprof http://localhost:6060/debug/pprof/goroutine")
	fmt.Println("程序将在 5 分钟后退出...")

	time.Sleep(5 * time.Minute)
	fmt.Println("程序退出")
}

运行观察：

数据采集方式

通过 HTTP 接口采集

以下两种方案均可：

go tool pprof -http=:8080 http://localhost:6060/debug/goroutine
http://localhost:6060/debug/pprof/goroutine

通过程序运行时采集

import _ “net/http/pprof”

初始状态：
- 程序启动初期存在 sync.Mutex.Lock 和 channel 阻塞：
1分钟后（锁释放）：
2分钟后（channel 解除阻塞）：

持续更新……

Go Delve 调试指南

Tue, 10 Jun 2025 12:07:18 +0800

背景：

在 Kubernetes 集群中部署容器化应用时，若依赖的远程数据源出现异常且无法在本地测试环境模拟相同数据条件，可能导致问题难以在开发环境中重现。此时，需要使用远程 dlv 调试技术对生产环境中的容器实例进行实时诊断和问题追踪。

实现过程：

本文以 deployment 方式实现该功能：

一、修改 YAML 配置文件

方式一：Sidecar 模式

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70


apiVersion: apps/v1
kind: Deployment
metadata:
 name: xxxname
 namespace: namespace
spec:
 replicas: 1
 selector:
 matchLabels:
 xxx: xxx
 template:
 metadata:
 labels:
 xxx: xxx
 spec:
 containers:
 # 主应用容器 - 添加调试环境变量
 - name: xxxname
 command:
 - ./startapp
 - --config-file=/xxxx
 image: xxx
 env:
 - name: GODEBUG
 value: "gctrace=1"
 - name: GOMAXPROCS
 value: "2"
 ports:
 - containerPort: 8888
 name: before_biz_port
 protocol: TCP
 # 添加调试端口
 - containerPort: 2345
 name: dlv-debug
 protocol: TCP
 resources:
 requests:
 cpu: 500m
 memory: 1Gi
 limits:
 cpu: 1000m
 memory: 2Gi

 # Delve 调试 Sidecar
 - name: dlv-debugger
 image: golang:1.21-alpine
 command:
 - /bin/sh
 - -c
 - |
 apk add --no-cache git
 go install github.com/go-delve/delve/cmd/dlv@latest
 /go/bin/dlv attach 1 --headless --listen=:2345 --api-version=2 --accept-multiclient --log
 securityContext:
 capabilities:
 add:
 - SYS_PTRACE
 privileged: false
 runAsUser: 0
 ports:
 - containerPort: 2345
 name: dlv-debug
 protocol: TCP
 volumeMounts:
 - mountPath: /logs
 name: logs
 readOnly: true
 volumes:
 - emptyDir: {}
 name: logs

方式二：直接集成模式

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26


# 在主容器中集成调试功能
- name: xxx
 command:
 - /bin/sh
 - -c
 - |
 # 安装 delve（如镜像中未包含）
 if ! command -v dlv &> /dev/null; then
 go install github.com/go-delve/delve/cmd/dlv@latest
 fi
 
 # 使用 delve 启动程序
 /go/bin/dlv exec --headless --listen=:2345 --api-version=2 --accept-multiclient \
 ./xxx -- \
 --config-file=/xxx
 securityContext:
 capabilities:
 add:
 - SYS_PTRACE
 ports:
 - containerPort: 8888
 name: before_biz_port
 protocol: TCP
 - containerPort: 2345
 name: dlv-debug
 protocol: TCP

关键参数说明：

attach 1：附加到 PID 为 1 的进程（Kubernetes 容器中的主进程）
--headless：无头模式，仅运行调试服务器
--listen=:2345：监听 2345 端口
--api-version=2：使用 JSON-RPC API 版本 2
--accept-multiclient：允许多个调试客户端连接
--log：启用调试日志输出

二、本地端口转发

`1`	`kubectl port-forward deployment/xxx 2345:2345 -n name_space`

Debugging on DK Blog