统一错误处理通过中间件和ErrorResponse结构实现，捕获panic并标准化响应。中间件使用defer+recover防止崩溃，writeError函数简化错误返回，结合路由集成，确保API错误响应一致、可维护。
在Go语言开发Web服务时，统一错误处理是保证API响应一致性和可维护性的关键。通过中间件机制，我们可以集中处理HTTP请求中的错误，返回标准化的错误响应格式，避免散落在各处的错误处理代码。
统一错误响应结构
定义一个通用的错误响应格式，便于前端解析和日志记录。
type ErrorResponse struct {
Code int `json:"code"`
Message string `json:"message"`
Data any `json:"data,omitempty"`
}
这个结构包含状态码、描述信息和可选的数据字段。可以根据业务需要扩展字段，比如加入请求ID或时间戳。
错误处理中间件实现
中间件捕获处理过程中的panic和显式错误，转换为统一格式返回。
立即学习“go语言免费学习笔记（深入）”；
func ErrorHandlingMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
// 捕获panic
defer func() {
if err := recover(); err != nil {
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(http.StatusInternalServerError)
json.NewEncoder(w).Encode(ErrorResponse{
Code: http.StatusInternalServerError,
Message: "Internal server error",
})
}
}()
// 调用下一层处理器
next.ServeHTTP(w, r)
})
}
该中间件使用defer和recover捕获运行时panic，防止服务崩溃，同时确保错误能被格式化返回。
主动返回错误的辅助函数
func writeError(w http.ResponseWriter, code int, message string) {
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(code)
json.NewEncoder(w).Encode(ErrorResponse{
Code: code,
Message: message,
})
}
// 在handler中使用
func userHandler(w http.ResponseWriter, r *http.Request) {
user, err := getUser(r.Context())
if err != nil {
writeError(w, http.StatusNotFound, "User not found")
return
}
json.NewEncoder(w).Encode(user)
}
通过封装writeError函数，业务逻辑中可以快速返回标准错误，减少重复代码。
集成到HTTP服务
将中间件应用到路由，实现全局错误处理。
func main() {
mux := http.NewServeMux()
mux.HandleFunc("/user", userHandler)
handler := ErrorHandlingMiddleware(mux)
http.ListenAndServe(":8080", handler)
}
所有经过该中间件的请求都会受到错误处理保护，即使未显式处理的panic也会被兜底捕获。
基本上就这些。一个简洁的错误中间件加上辅助函数，就能让Go的HTTP服务拥有清晰一致的错误输出。不复杂但容易忽略细节，比如Content-Type设置和defer的正确使用。
