统一错误处理通过中间件和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的正确使用。
以上就是Golang HTTP错误处理 统一错误响应中间件的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1406635.html
微信扫一扫 
支付宝扫一扫 
