如何防止Go程序中未处理的panic导致应用进程崩溃？

1. 为每个Goroutine添加Panic捕获机制 #

Go中单个Goroutine的Panic不会自动扩散到其他Goroutine，但未捕获的Panic会直接导致整个进程崩溃。因此每个异步启动的Goroutine都必须用defer + recover()包裹核心逻辑：

import (
    "log"
    "runtime/debug"
)

func asyncTask() {
    // 必须在Goroutine最开头声明defer，确保能捕获所有后续逻辑的Panic
    defer func() {
        if p := recover(); p != nil {
            // 记录Panic信息和调用栈，方便后续排查问题
            log.Printf("[AsyncTask] Panic recovered: %v", p)
            debug.PrintStack()
            // 这里可添加监控上报逻辑，及时触发告警
        }
    }()

    // 放置可能触发Panic的业务代码
    panic("unexpected error in async task")
}

注意：recover()只能在defer函数内生效，且无法跨Goroutine捕获Panic。

2. Web服务用中间件全局拦截请求Panic #

如果是HTTP服务，单个请求的Panic不该导致整个服务挂掉。可以写一个全局中间件，为每个请求添加Panic捕获逻辑：

import (
    "net/http"
    "log"
    "runtime/debug"
)

func panicRecovery(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        defer func() {
            if p := recover(); p != nil {
                // 返回500状态码给客户端，避免请求长时间挂起
                w.WriteHeader(http.StatusInternalServerError)
                w.Write([]byte("Internal Server Error"))
                // 记录请求上下文和Panic详情，便于定位问题
                log.Printf("[RequestPanic] path: %s, method: %s, error: %v", r.URL.Path, r.Method, p)
                debug.PrintStack()
            }
        }()
        next.ServeHTTP(w, r)
    })
}

// 使用方式：将中间件加到路由最外层
func main() {
    mux := http.NewServeMux()
    mux.HandleFunc("/api/resource", resourceHandler)
    // 用中间件包裹整个路由，实现全局Panic拦截
    http.ListenAndServe(":8080", panicRecovery(mux))
}

3. 封装下游风险调用，隔离Panic #

对下游可能触发Panic的函数（比如第三方库、不稳定的依赖），封装一层安全调用函数，把Panic转为可处理的Error：

import (
    "fmt"
    "log"
    "runtime/debug"
)

// SafeCall 包裹可能触发Panic的函数，将Panic转为Error返回
func SafeCall(fn func()) error {
    var err error
    defer func() {
        if p := recover(); p != nil {
            debug.PrintStack()
            err = fmt.Errorf("panic recovered: %v", p)
        }
    }()
    fn()
    return err
}

// 调用示例
func main() {
    err := SafeCall(func() {
        // 调用下游可能触发Panic的函数
        riskyDownstreamFunction()
    })
    if err != nil {
        // 正常处理错误，比如打印日志、返回友好提示给客户端
        log.Println("Downstream call failed:", err)
    }
}

4. 配套监控与告警 #

捕获Panic后不要只打日志，要把Panic事件上报到监控系统（比如自定义指标、Prometheus），设置告警规则。这样能第一时间发现系统中的潜在问题，而不是等用户反馈。

额外建议：从源头减少Panic #

• 优先用error而非panic：只有程序遇到不可恢复的致命错误（比如nil指针解引用、数组越界）时才用Panic，业务错误一律返回error。
• 严格代码检查：用go vet、静态分析工具提前发现可能触发Panic的代码（比如未初始化的指针）。

内容的提问来源于stack exchange，提问作者Siva