使用中间件统一处理错误是Go语言构建HTTP服务器的关键实践，通过自定义HandlerFunc类型返回error，并在中间件中集中处理，避免重复代码。应区分客户端错误（如400、404）和服务端错误（500），通过自定义错误类型如ClientError判断并返回合适状态码。同时引入recover中间件防止panic导致服务中断，并记录包含请求方法、路径、IP等上下文信息的日志，提升排查效率。结合结构化日志和监控上报，可显著增强服务的稳定性和可维护性。
在Go语言构建HTTP服务器时，错误处理是确保服务稳定和可维护的关键环节。很多开发者初期会直接在handler中使用log.Fatal或忽略错误，这会导致程序崩溃或难以排查问题。正确的做法是统一、清晰地处理错误，并返回合适的HTTP状态码给客户端。
使用中间件统一处理错误
最有效的错误处理方式之一是通过中间件捕获handler中传递的错误，并进行集中处理。这样可以避免在每个handler中重复写日志、设置状态码等逻辑。
定义一个返回error的handler类型：
type HandlerFunc func(w http.ResponseWriter, r *http.Request) error然后编写中间件将其适配为标准的http.HandlerFunc：
立即学习“go语言免费学习笔记（深入）”；
func middleware(h HandlerFunc) http.HandlerFunc { return func(w http.ResponseWriter, r *http.Request) { if err := h(w, r); err != nil { // 可根据错误类型判断返回500、400等不同状态码 http.Error(w, "Internal Server Error", http.StatusInternalServerError) log.Printf("HTTP handler error: %v", err) } } }使用示例：
http.HandleFunc("/api/data", middleware(func(w http.ResponseWriter, r *http.Request) error { if r.Method != "GET" { return errors.New("method not allowed") } // 模拟业务逻辑错误 data, err := fetchData() if err != nil { return fmt.Errorf("failed to fetch data: %w", err) } w.Header().Set("Content-Type", "application/json") json.NewEncoder(w).Encode(data) return nil }))区分客户端与服务端错误
不是所有错误都应该返回500。合理区分错误类型能帮助客户端正确响应。
建议做法：
- 输入校验失败、资源未找到等应返回4xx状态码（如400、404）
- 数据库查询失败、网络调用异常等返回500
- 可自定义错误类型来标识客户端错误
例如：
在中间件中判断：
if errors.As(err, &ClientError{}) { http.Error(w, err.Error(), http.StatusBadRequest) } else { http.Error(w, "Internal Server Error", http.StatusInternalServerError) }避免panic，但可配合recover兜底
虽然Go的HTTP服务器在panic后仍能继续运行其他请求，但未处理的panic会导致当前请求无响应或返回500，且缺乏上下文信息。
推荐添加recover中间件防止服务中断：
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 recovered: %v\nStack trace: %s", r, debug.Stack()) http.Error(w, "Internal Server Error", http.StatusInternalServerError) } }() next.ServeHTTP(w, r) }) }将此中间件包裹整个路由，作为最后一道防线。
记录错误上下文以便排查
仅记录错误字符串往往不够。建议记录请求方法、路径、用户IP、时间等信息，便于定位问题。
可在中间件中增强日志输出：
log.Printf("Error in %s %s from %s: %v", r.Method, r.URL.Path, r.RemoteAddr, err)对于重要服务，可集成结构化日志库如zap或logrus，并上报到监控系统。
基本上就这些。通过统一的错误处理机制，可以让Golang HTTP服务更健壮、易维护。关键是把错误视为流程的一部分，而不是异常情况。
