排查go panic需分四步：先用顶层recover判断是否被截获；再设gotraceback=all获取全goroutine堆栈；接着用debug.stack()定位“created by”业务入口；最后用go tool trace分析阻塞型panic。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
排查Go程序中未捕获的panic是线上服务稳定性保障的关键动作，尤其当错误日志只显示“fatal error”而缺失业务上下文和调用链时，必须借助Codex（指代Go生态中集成调试能力的CLI工具链，含go tool trace、pprof、debug.Stack等组合）进行穿透式分析。
确认panic是否被recover截获
先检查主goroutine入口是否包裹了顶层recover：在main函数或HTTP handler最外层加defer func(){if r := recover(); r != nil { log.Printf("PANIC: %v", r) } }()。若日志中完全无recover输出，说明panic发生在init阶段、子goroutine或第三方中间件拦截后未透传的位置。
【子goroutine panic无法被主handler的defer捕获】——比如在http.HandlerFunc里起go sendMetric()，该goroutine内访问nil指针，主流程recover完全收不到。
启用GOTRACEBACK获取完整堆栈快照
在运行程序前设置环境变量：GOTRACEBACK=all go run main.go。这会强制运行时打印所有goroutine的当前调用帧，包括runtime内部goroutine，避免关键线索被截断。
对比不同级别效果：single仅显示触发panic的goroutine；all能暴露阻塞在channel或锁上的其他goroutine；system还包含调度器底层状态，适合排查死锁类panic。
若程序部署在Kubernetes中，需在容器启动命令中注入该环境变量，而非仅本地测试时设置。
从panic日志定位真实业务行号
第一步：找到panic日志中最顶部的goroutine 1 [running]段落，它指示panic发生的确切位置。
第二步：检查该行是否落在runtime/http/net等标准库路径下。若是，说明上层业务函数已被截断——默认panic堆栈只保留活跃帧，经ServeHTTP等中间层后业务代码消失。
第三步：在recover逻辑中显式调用debug.Stack()并记录返回值。【必须转成string再写入日志，否则log.Printf输出的是[]byte内存地址】
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
第四步：在debug.Stack()输出中搜索“created by”行，它指向goroutine的启动源头，这才是真正的业务入口点，比如created by main.startWorker at worker.go:42。
用go tool trace交互式排查阻塞型panic
方法一：启动带trace支持的程序
在main函数开头添加import _ "net/http/pprof"，并启动HTTP服务：go http.ListenAndServe("localhost:6060", nil)。
方法二：触发panic后立即抓取trace
执行curl "http://localhost:6060/debug/trace?seconds=5"下载trace.out文件。
方法三：离线分析阻塞路径
运行go tool trace trace.out，在Web UI中切换到“Goroutine”标签页，筛选状态为chan send或mutex lock的goroutine，观察其阻塞时长和等待对象。
注意：trace无法回溯已结束的goroutine，必须在panic发生前开启采集，因此建议长期运行的服务默认启用trace endpoint。
快速验证nil pointer panic源头
遇到invalid memory address or nil pointer dereference时，直接查看panic堆栈顶部的文件行号，定位到该行的结构体指针调用（如u.Name或svc.Do()）。
检查该指针变量的初始化路径：是否来自new()但未赋值字段？是否由工厂函数返回nil？是否在类型断言后未判ok就直接解引用？
在可疑位置插入log.Printf("u=%v, u!=nil=%t", u, u != nil)，确认nil状态是否符合预期——这比静态分析更快暴露空值传播路径。
