Golang中间件错误处理技巧

使用recover捕获panic防止服务崩溃，defer中调用recover拦截运行时错误；2. 通过自定义responseWriter记录状态码，结合context传递业务错误；3. 统一输出JSON错误响应，确保日志与响应格式一致，实现可控错误处理流程。

在Go语言的Web服务开发中，中间件是处理请求前后的逻辑核心。当涉及到错误处理时，关键在于统一拦截、记录并返回合适的响应，同时避免程序崩溃。Golang没有异常机制，panic会直接中断流程，因此中间件需要结合recover和自定义错误来实现优雅处理。

使用recover捕获panic

HTTP处理器如果发生panic，会导致整个服务中断。中间件可以通过defer和recover捕获运行时错误，防止服务崩溃。

示例代码：

func RecoverMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        defer func() {
            if err := recover(); err != nil {
                log.Printf("Panic recovered: %v", err)
                http.Error(w, "Internal Server Error", http.StatusInternalServerError)
            }
        }()
        next.ServeHTTP(w, r)
    })
}

统一处理业务错误

除了系统级panic，业务逻辑中的错误也需要在中间件层面统一处理。可以通过自定义错误类型或上下文传递错误信息。

一种常见做法是定义一个响应包装器，记录状态码，便于后续判断是否出错。

• 创建responseWriter包装http.ResponseWriter，记录写入的状态码
• 在后续中间件或处理器中触发错误时，不立即返回，而是通过上下文或公共结构体传递错误
• 最终由错误处理中间件统一输出JSON或其他格式的错误响应

结合context传递错误信息

利用context.Context可以在请求生命周期内传递值，包括错误状态。例如，在处理器中将错误存入context，由日志或响应中间件读取并处理。

示例思路：

• 定义键类型：type errorKey struct{}
• 设置错误：ctx = context.WithValue(r.Context(), errorKey{}, fmt.Errorf("invalid input"))
• 在后置中间件中检查context是否存在错误，并返回对应响应

基本上就这些。通过recover防崩、自定义错误传递、context配合，就能在Golang中间件中实现清晰可控的错误处理流程。关键是提前设计好错误响应格式和日志策略，保持一致性。