使用中间件统一处理错误是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：
使用示例：
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服务更健壮、易维护。关键是把错误视为流程的一部分，而不是异常情况。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
