使用go run -race检测数据竞争，结合runtime.NumGoroutine监控协程数量，通过pprof分析阻塞调用栈，利用select超时避免永久阻塞，有效排查goroutine泄漏、死锁和数据竞争问题。
Go语言的goroutine和channel是并发编程的核心，但它们也带来了调试上的挑战。由于并发执行的不确定性，传统的调试方法往往难以捕捉问题。下面是一些实用的调试技巧，帮助你更高效地排查goroutine泄漏、死锁、数据竞争等问题。
使用go run -race检测数据竞争
数据竞争是并发程序中最常见的错误之一。Go提供了内置的竞争检测工具，只需在运行程序时加上-race标志：
它会报告读写共享变量时是否存在竞争。虽然会降低程序性能，但在测试阶段非常值得启用。常见输出包括：
- 两个goroutine同时对同一变量进行未同步的读写
- channel的发送与接收发生在不一致的时机
- map被多个goroutine同时写入
一旦发现警告，应立即通过互斥锁或channel同步机制修复。
立即学习“go语言免费学习笔记（深入）”；
监控活跃的goroutine数量
goroutine泄漏会导致内存增长甚至程序崩溃。你可以通过以下方式监控当前运行的goroutine数：
runtime.NumGoroutine()在关键位置打印这个值，观察其变化趋势。例如：
启动前： goroutines: 1
启动10个worker后： goroutines: 11
期望全部退出后： goroutines仍为11 → 可能存在泄漏
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
结合pprof可以进一步查看具体是哪些函数阻塞了goroutine。
利用pprof分析阻塞和调用栈
导入net/http/pprof包可开启调试接口：
import _ "net/http/pprof"
// 在main中启动服务
go func() {
log.Println(http.ListenAndServe("localhost:6060", nil))
}()然后访问http://localhost:6060/debug/pprof/goroutine?debug=2，可以看到所有goroutine的完整调用栈。查找处于chan receive、chan send或select状态的goroutine，判断是否因channel未关闭或等待条件永远不成立而卡住。
给channel操作加超时避免永久阻塞
调试期间，长时间阻塞会让问题更难定位。使用select配合time.After设置超时：
select {
case data := <-ch:
fmt.Println("received:", data)
case <-time.After(3 * time.Second):
fmt.Println("timeout,可能channel无数据或发送方出错")
}这能帮你快速发现哪一侧goroutine没有按预期工作。
打印goroutine ID辅助追踪执行流
标准log不显示goroutine ID，难以区分输出来源。可以通过以下方式获取ID（注意：非官方API，仅用于调试）：
func getGID() uint64 {
b := make([]byte, 64)
b = b[:runtime.Stack(b, false)]
b = bytes.TrimPrefix(b, []byte("goroutine "))
b = b[:bytes.IndexByte(b, ' ')]
n, _ := strconv.ParseUint(string(b), 10, 64)
return n
}在日志中加入gid，如：
[GID:12] worker started
这样能清晰看到每个goroutine的行为轨迹。
基本上就这些。关键是结合工具主动暴露问题，而不是依赖肉眼排查。调试并发程序要像侦探一样，收集线索、验证假设。-race、pprof、超时、日志标记，都是你的有力工具。
