使用中间件统一处理Go HTTP错误，通过定义ErrorResponse结构和ErrorMiddlewareAdv函数，结合defer/recover捕获panic，推荐用error返回替代panic，实现错误集中处理。
在 Go 的 HTTP 服务中，统一处理错误是提升代码可维护性和 API 一致性的关键。通过设计中间件捕获路由处理函数中的错误，可以避免在每个 handler 中重复写错误响应逻辑。
使用中间件统一处理错误
Go 的 net/http 本身不提供异常机制，但可以通过中间件包装 handler，利用 defer 和 recover 捕获 panic，同时定义统一的错误响应格式。
核心思路是：创建一个装饰器函数，将普通的
http.HandlerFunc包装成能自动处理错误的版本。 示例：定义统一错误响应结构
type ErrorResponse struct {
Error string `json:"error"`
Status int `json:"status"`
}
示例：错误处理中间件
func ErrorMiddleware(next http.HandlerFunc) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
// 捕获 panic
defer func() {
if err := recover(); err != nil {
var errorMsg string
var statusCode = http.StatusInternalServerError
switch e := err.(type) {
case string:
errorMsg = e
case error:
errorMsg = e.Error()
default:
errorMsg = "internal server error"
}
log.Printf("Panic: %v", errorMsg)
sendErrorResponse(w, statusCode, errorMsg)
}
}()
// 正常执行 handler
next(w, r)
}
}
func sendErrorResponse(w http.ResponseWriter, status int, message string) {
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(status)
json.NewEncoder(w).Encode(ErrorResponse{
Error: message,
Status: status,
})
}
在路由中使用错误中间件
将业务 handler 用中间件包装，即可自动处理错误。
立即学习“go语言免费学习笔记（深入）”；
示例：注册路由
func main() {
http.HandleFunc("/user", ErrorMiddleware(func(w http.ResponseWriter, r *http.Request) {
if r.Method != "GET" {
panic("method not allowed")
}
// 模拟业务错误
if someCondition {
panic("user not found")
}
fmt.Fprintf(w, `{"data": "ok"}`)
}))
http.ListenAndServe(":8080", nil)
}
主动返回错误而非 panic
虽然 panic 能被 recover 捕获，但更推荐通过返回 error 来控制流程，保持程序稳定性。
改进：使用 error 返回代替 panic
type HttpHandler func(w http.ResponseWriter, r *http.Request) error
func ErrorMiddlewareAdv(next HttpHandler) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
if err := next(w, r); err != nil {
log.Printf("Handler error: %v", err)
sendErrorResponse(w, http.StatusInternalServerError, err.Error())
}
}
}
// 使用示例
http.HandleFunc("/data", ErrorMiddlewareAdv(func(w http.ResponseWriter, r *http.Request) error {
if r.Header.Get("Authorization") == "" {
return errors.New("missing auth header")
}
fmt.Fprintf(w, `{"result": "success"}`)
return nil
}))
这种方式更清晰，避免滥用 panic，同时仍能统一处理错误。
基本上就这些。中间件 + error 返回 + 统一响应格式，是 Go 中处理 HTTP 错误的简洁可靠方案。
