HTTP handler 中 panic 会静默终止 goroutine,需在同 goroutine 内用 defer recover() 捕获并主动返回响应;新 goroutine 必须自行 recover;仅对运行时不可控错误 recover,初始化失败可 panic,业务错误应返回 error。

HTTP handler 里 panic 会直接杀掉 goroutine
Go 的 http.Server 每次请求都起一个新 goroutine,这个 goroutine 里如果发生 panic,且没被 recover,整个 goroutine 就静默退出——连接挂起、响应不发、日志可能也不全。你看到的典型错误是:http: panic serving 127.0.0.1:8080: runtime error: invalid memory address。
这不是服务整体退出,而是单个请求处理崩了。但大量这类 panic 会堆积 goroutine、耗尽内存、拖慢服务,最终看起来像“服务退出”。
- recover 必须在同一个 goroutine 内、panic 发生前就注册好,
defer recover()要紧贴 handler 执行逻辑 - 不能写成
go func() { defer recover() }(),这毫无作用 - 必须检查
recover()返回值,不读返回值等于没写 - 恢复后要主动调用
http.Error()或写响应体,否则客户端永远卡住
goroutine 内部 panic 必须自己 recover
只要开了新 goroutine(比如 go doWork()),它里面的 panic 就和父 goroutine 完全无关。main 函数或中间件里的 recover 对它无效。
常见误操作:在启动后台任务时漏掉 defer-recover,结果某个定时任务 panic 后 goroutine 消失,定时逻辑永久中断,但主服务还在跑,问题极难发现。
- 每个独立 goroutine 都要配自己的
defer func() { if r := recover(); r != nil { /* 记录 + 清理 */ } }() - 尤其注意
time.AfterFunc、time.Ticker、worker pool 中的 worker goroutine - 不要依赖“上层 recover”,Go 不支持跨 goroutine 错误捕获
哪些 panic 根本不该 recover
不是所有 panic 都适合捕获。有些 panic 是开发阶段该暴露的问题,强行 recover 只会让故障延迟发现、定位变难。
比如:json.Unmarshal 因结构体 tag 写错 panic、template.Parse 遇到非法语法 panic、第三方库初始化失败 panic——这些说明代码有硬伤,线上运行时 recover 后返回 500,你根本不知道是哪行配置错了。
- 只对运行时不可控错误做 recover:如第三方 HTTP 调用中对方返回非法 JSON、数据库连接突然断开后未判 err 就解引用
- 对类型错误、配置错误、逻辑 bug 导致的 panic,应修复代码,而不是包一层 recover 掩盖
- 用
go vet和静态检查工具提前拦截大部分可预防 panic
panic 不是 error 替代品,别滥用
把用户输入校验失败、API 返回 404、文件不存在等场景写成 panic,等于把可控错误变成不可恢复崩溃。这些本该返回 error,由 handler 统一转成 400/404 响应。
滥用 panic 最直接的后果:你写的中间件 recover 逻辑越写越多,却掩盖了真正该修的 bug;日志里全是泛泛的 panic recovered: interface conversion: interface {} is nil, not string,但找不到源头。
- 初始化失败(如加载证书失败、连不上 Redis)才该 panic,因为后续根本没法运行
- 运行时业务错误一律走
error返回路径,配合fmt.Errorf("%w", err)包装上下文 - 避免封装
MustXXX类函数,除非你 100% 确认它只用于 init 阶段且失败即停服
复杂点在于:recover 位置、goroutine 边界、panic 性质三者必须同时判断清楚。漏掉任一环,你的“防 panic”就只是心理安慰。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











