Golang HTTP错误处理统一错误响应中间件-Golang-PHP中文网

Golang HTTP错误处理统一错误响应中间件

P粉602998670

发布： 2025-09-17 08:29:01

原创

230人浏览过

统一错误处理通过中间件和ErrorResponse结构实现，捕获panic并标准化响应。中间件使用defer+recover防止崩溃，writeError函数简化错误返回，结合路由集成，确保API错误响应一致、可维护。

golang http错误处理统一错误响应中间件

在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)
    })
}
</font>

登录后复制

该中间件使用defer和recover捕获运行时panic，防止服务崩溃，同时确保错误能被格式化返回。

MAC风格响应式后台管理模版

MAC风格响应式后台管理模版是一款基于Bootstrap、jQuery等技术制作的MAC苹果风格后台管理系统模板，界面清新，有登录页面，注册页，帮助页，404错误页，购物清单，个人资料，相册页面，首页，插件页面，页面模板，图标，表格，表单，UI图标，日历等系统功能菜单，共有21个模板页面。

338

查看详情

主动返回错误的辅助函数

提供工具函数让处理器内部能方便地返回统一错误。

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错误处理统一错误响应中间件的详细内容，更多请关注php中文网其它相关文章！