Golang Web开发中如何处理panic_Golang异常恢复中间件实现-Golang-PHP中文网

recover必须在defer函数中调用，因为仅在defer执行期间有效且只能捕获当前goroutine的panic；普通调用或非defer中调用始终返回nil。

golang web开发中如何处理panic_golang异常恢复中间件实现

为什么 `recover` 必须在 `defer` 函数里调用

因为 recover 只有在 defer 执行期间才有效，且仅能捕获当前 goroutine 的 panic。如果写成普通函数调用，或放在非 defer 语句中，recover 永远返回 nil，起不到恢复作用。

常见错误写法：

func badMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        // ❌ 错误：recover 不在 defer 中，永远无效
        if err := recover(); err != nil {
            log.Printf("panic recovered: %v", err)
        }
        next.ServeHTTP(w, r)
    })
}

正确结构必须是：

defer 包裹一个匿名函数
该匿名函数内第一行就调用 recover()
不能跨 goroutine（比如在 go func() { ... }() 里 recover）

HTTP 中间件中安全封装 `recover` 的典型模式

核心是把 panic 捕获、日志记录、错误响应三件事串起来，同时避免影响原有 response 流程（比如 header 已写入时不能再写 body）。

实操要点：

用 http.NewResponseWriter 或自定义 responseWriter 拦截写入，判断 Header().Get("Content-Type") 是否已设置，防止 http.Error 报 http: multiple response.WriteHeader calls
panic 值可能是 string、error、nil，建议统一转为 fmt.Sprintf("%v", r) 输出，避免类型断言失败
记录 panic 时带上堆栈：debug.PrintStack() 或 runtime/debug.Stack()，但注意后者返回 []byte，需转 string

简短示例：

func recoverMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        defer func() {
            if r := recover(); r != nil {
                log.Printf("PANIC in %s %s: %v", r.Method, r.URL.Path, r)
                log.Printf("Stack trace:\n%s", debug.Stack())
                http.Error(w, "Internal Server Error", http.StatusInternalServerError)
            }
        }()
        next.ServeHTTP(w, r)
    })
}

如何避免中间件里 panic 恢复后继续执行后续逻辑

recover 只是“停止 panic 传播”，并不会自动跳过 next.ServeHTTP 后的代码。如果没控制好流程，可能造成重复写 response 或状态不一致。

Json Repair Kit

使用 Node.js 评估修复格式错误的 JSON，自动纠正尾随逗号、单引号、未加引号的键等常见问题，实现文件规范化。

下载

关键点：

recover() 后必须显式 return，否则会继续往下走
不要在 defer 函数里做业务重试或 fallback 处理——这不是 recover 的职责
若需定制错误页，用模板渲染代替 http.Error，并确保只写一次 w.WriteHeader

容易被忽略的坑：

比如下面这段代码会在 panic 后仍执行 log.Println("after serve")：

defer func() {
    if r := recover(); r != nil {
        http.Error(w, "Oops", 500)
        // ❌ 缺少 return，后续代码照常执行
    }
}()
next.ServeHTTP(w, r)
log.Println("after serve") // 这行仍会执行