

新闻资讯
技术教程Go HTTP服务中panic不会导致进程崩溃,因标准库自动recover并记录日志,但不返回响应;必须在每个handler内用defer+recover手动捕获,区分error与panic,避免跨goroutine漏捕。
Go 的 http.ServeHTTP 默认对每个请求启动独立 goroutine,单个请求 panic 只影响当前 goroutine。标准库已内置 recover 机制——它会在 http.serverHandler.ServeHTTP 中捕获 panic,并记录日志(log.Printf("http: panic serving %v: %v", c.remoteAddr, err)),然后关闭连接。这意味着:服务进程本身不会退出,其他请求照常处理。
但默认行为有明显缺陷:不返回可读错误响应、不记录堆栈、不触发监控告警、无法自定义错误码或格式。
不能只在顶层 middleware 里 recover —— 如果 panic 发生在中间件之后(比如业务逻辑里),而中间件没做 defer,就还是会漏掉。最保险的方式是:每个 http.HandlerFunc 都自己处理。
func myHandler(w http.ResponseWriter, r *http.Request) {
defer func() {
if err := recover(); err != nil {
http.Error(w, "Internal Server Error", http.StatusInternalServerError)
log.Printf("panic recovered in %s: %+v\n", r.URL.Path, err)
// 可选:上报 Sentry / Prometheus
}
}()
// 正常业务逻辑
db.QueryRow("SELECT ...").Scan(&user.ID) // 可能 panic(如空指针)
}
fmt.Sprintf("%+v", err) 打印完整堆栈http.Error 返回泛泛的 500,应根据 panic 类型区分:如 *sql.ErrNoRows 不该 panic,而是正常处理;真正该 panic 的是 nil pointer dereference
main 函数或包初始化中发生的 panic 无法被 HTTP 层捕获,会导致整个进程退出。这类 panic 必须在 main() 入口处显式 recover:
立即学习“go语言免费学习笔记(深入)”;
func main() {
defer func() {
if r := re
cover(); r != nil {
log.Fatalf("FATAL PANIC in main: %+v", r)
os.Exit(1)
}
}()
http.ListenAndServe(":8080", mux)
}
go run -gcflags="-l" ./main.go 关闭内联,便于定位原始 panic 行号Go 的哲学是「error 用于可预期的失败,panic 用于不可恢复的程序错误」。常见误用:
sql.ErrNoRows 是正常 error,不应 panic;但 db == nil 导致的 nil pointer dereference 才是 panic 级别json.Unmarshal 返回 error)不该 panic;但传入 nil 指针给 json.Unmarshal 会 paniclog.Fatal 替代 panic 同样危险——它调用 os.Exit(1),直接杀进程真正需要 panic 的场景极少:配置严重缺失(如未设置 DB DSN)、关键依赖未初始化、内存分配失败(极罕见)。其余一律走 error 返回 + handler 内部判断。
最易忽略的是:recover 只能捕获当前 goroutine 的 panic。如果业务代码启了新 goroutine(比如 go sendEmail()),它里面的 panic 无法被 handler 的 defer 捕获,必须在那个 goroutine 内部单独加 defer。