通过中间件实现统一错误处理，可捕获panic并返回标准JSON响应，结合自定义AppError类型与日志上下文，提升Go Web服务的稳定性与可观测性。
在Go语言的Web开发中，HTTP中间件是处理公共逻辑的理想方式。统一错误处理作为核心需求之一，能显著提升代码可维护性和API稳定性。直接在每个Handler里写错误捕获不仅重复，还容易遗漏。通过中间件实现统一错误恢复，是最优解。
使用中间件捕获panic并返回标准错误响应
Go的HTTP服务一旦发生未捕获的panic，会导致整个程序崩溃或连接中断。通过中间件结合recover机制，可以安全拦截运行时异常，并返回友好的JSON响应。
示例如下：
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: %v\n", err)
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(http.StatusInternalServerError)
json.NewEncoder(w).Encode(map[string]string{
"error": "Internal server error",
})
}
}()
next.ServeHTTP(w, r)
})
}
将此中间件置于调用链顶层，确保所有后续Handler中的panic都能被捕获。
立即学习“go语言免费学习笔记（深入）”；
定义统一错误结构体与主动抛错机制
除了被动捕获panic，业务逻辑中常需主动返回特定错误码。为此可定义应用级错误类型，配合中间件统一输出格式。
建议做法：
企业网站管理系统YothCMS 1.0 修正版
下载
YothCMS是由 石家庄优斯科技有限公司开发的一套完全开源建站系统，主要面向企业进行快速的建造简洁，高效，易用，安全的公司企业网门户站，稍具技术的开发人员就能够使用本系统以最低的成本、最少的人力投入在最短的时间内架设一个功能齐全、性能优越的公司企业网站。YothCMS是基于ASP+Access开发的一款轻巧高效的网站内容管理系统，提供了新闻管理模块，产品管理模块，文件管理模块。在使用过程中可以轻
- 创建自定义错误类型，包含状态码和消息
- 在Handler中通过panic该错误对象触发中间件处理
- 中间件识别是否为预期错误，避免泄露敏感信息
type AppError struct {
Code int `json:"code"`
Msg string `json:"msg"`
}
func (e AppError) Error() string {
return e.Msg
}
// 在handler中使用
if userNotFound {
panic(AppError{Code: 404, Msg: "User not found"})
}
中间件中判断类型，对AppError使用其Code作为HTTP状态码，普通panic则返回500。
结合日志与上下文增强可观测性
生产环境需要更详细的错误追踪。可在中间件中加入请求ID、记录耗时、输出结构化日志。
改进后的recover逻辑：
defer func() {
if r := recover(); r != nil {
reqID := r.Context().Value("reqID") // 来自上下文
logEntry := map[string]interface{}{
"level": "error",
"req_id": reqID,
"method": r.Method,
"url": r.URL.Path,
"panic": fmt.Sprintf("%v", r),
"stack": string(debug.Stack()),
}
log.Printf("ERROR: %+v", logEntry)
w.WriteHeader(http.StatusInternalServerError)
json.NewEncoder(w).Encode(map[string]string{"error": "server error"})
}
}()
这样既保证了用户看到简洁提示，又让运维具备完整排查依据。
基本上就这些。一个健壮的Golang HTTP服务，离不开这类透明且一致的错误处理机制。中间件模式让错误恢复变得集中可控，也更容易扩展限流、鉴权等其他功能。不复杂但容易忽略。
