CPU占用高90%非Gin本身问题,而是handler同步阻塞、GC频繁、日志锁争用或下游依赖卡住goroutine;需用pprof定位热点,重点关注top耗时函数、web调用图及runtime.mallocgc、json序列化、DB连接等高频消耗点。

CPU 占用过高,90% 不是 Gin 本身的问题,而是 handler 中的同步阻塞、GC 频繁、日志锁争用或下游依赖卡住 goroutine 导致的。直接上 pprof 定位热点,别猜。
用 pprof 快速定位 CPU 热点
在 main() 里加一行启动 pprof HTTP 服务:
import _ "net/http/pprof"
func main() {
go func() {
log.Println(http.ListenAndServe("localhost:6060", nil))
}()
// ... 启动 Gin
}
压测时访问 http://localhost:6060/debug/pprof/profile?seconds=30(默认采样 30 秒),下载 profile 文件后用:
go tool pprof -http=:8081 profile
重点关注:top 命令看耗时最长的函数;web 查调用图;特别留意是否大量时间花在 runtime.mallocgc、fmt.Sprintf、json.(*encodeState).marshal 或 database/sql.(*DB).conn 上。
高频 CPU 消耗点及对应修复
以下现象和解法一一对应,不是泛泛而谈:
-
日志中间件打满 CPU:用
fmt.Printf或未缓冲的os.Stdout写日志,高并发下write(2)系统调用锁争用严重 → 改用zerolog.New(os.Stderr)+With().Timestamp().Caller(),或至少套一层bufio.NewWriter -
JSON 序列化吃掉 40%+ CPU:
c.JSON(200, data)调用反射 + 堆分配 → 对固定结构体,用jsoniter.ConfigFastest.Marshal(data)替代;对简单 map,提前bytes, _ := jsoniter.Marshal(...)后c.Data(200, "application/json", bytes) -
GC 频繁拉高 schedlat:pprof 显示
runtime.mallocgc占比高 → 检查是否在 handler 里频繁 new struct/map/slice;用sync.Pool复用,比如var bufPool = sync.Pool{New: func() interface{} { return new(bytes.Buffer) }} -
数据库查询没设连接池上限:
db.QueryRow卡住,goroutine 挂起但 P 仍被占用 → 必须调db.SetMaxOpenConns(20)和db.SetMaxIdleConns(10),否则默认无限排队,P 空转等连接
GOMAXPROCS 设错导致 CPU 利用率虚高
容器中跑 runtime.NumCPU() 返回宿主机核数(比如 32),但 K8s 只给了 2 核 → Go 开 32 个 P 抢 2 个 vCPU,调度器疯狂 steal,go tool trace 里能看到大量 P idle 但 runnable goroutine 堆积。
必须在 main() 最开头设置:
- 推荐方式:启动时传环境变量
GOMAXPROCS=2,Go 运行时自动读取 - 代码读取 cgroup(v2):
os.ReadFile("/sys/fs/cgroup/cpu.max")解析max值,除以10000得 vCPU 数 - 绝对不要写:
runtime.GOMAXPROCS(runtime.NumCPU())或runtime.GOMAXPROCS(16)硬编码
设晚了就失效 —— http.ListenAndServe 一执行,就有 goroutine 绑定旧 P,后续改不回去了。
别忽略 I/O 密集型场景的“假 CPU 高”
top 显示 CPU 100%,但 pprof 里没看到业务函数?那大概率是:
- 网卡中断集中在单个 CPU(
cat /proc/interrupts | grep eth),需开启 RPS - Nginx worker 进程没开多进程或没绑核(
worker_processes auto+worker_cpu_affinity auto) - 下游 Redis/PostgreSQL 是单线程,Gin goroutine 全在
read系统调用上休眠,CPU 空转但调度器仍在轮询
这类问题改 Gin 代码毫无意义,得查基础设施层。真正该盯的,永远是 pprof 里排第一的函数,不是 top 里的数字。











