1.使用中间件统一捕获错误并返回结构化响应；2.定义自定义错误类型以统一错误格式；3.在业务逻辑中主动触发结构化错误。在go的web服务中，通过编写一个中间件函数包裹请求处理逻辑，可以集中拦截panic或其他错误，并根据错误类型返回一致的结构化响应，例如使用httpError结构体封装错误码和消息，同时结合框架如gin的abortwithstatusjson方法进一步简化错误响应，从而实现统一、清晰且易于维护的http错误处理机制。
在写 Go 的 Web 服务时，HTTP 错误处理容易变得分散、混乱。不同地方返回的错误格式不一致，调试和前端对接都很麻烦。解决这个问题的关键在于：用中间件统一捕获错误，并返回结构化的响应。
下面是一些实用做法，帮助你在项目中实现统一的 HTTP 错误响应。
中间件拦截错误，集中处理
Go 的标准库 net/http 或者像 Gin、echo 这类框架都支持中间件机制。你可以写一个中间件函数，在每次请求进入处理逻辑前包裹一层“错误捕获器”。
立即学习“go语言免费学习笔记（深入）”；
举个例子，中间件可以长这样：
func ErrorMiddleware(next http.Handler) http.Handler { return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { // 捕获 panic 或其他错误 defer func() { if err := recover(); err != nil { http.Error(w, "Internal Server Error", http.StatusInternalServerError) } }() next.ServeHTTP(w, r) }) }
这个中间件会在每个请求结束时检查是否有 panic 发生，如果有就返回统一的 500 响应。你也可以在里面加更多逻辑，比如记录日志、封装成 JSON 格式等。
自定义错误类型，方便区分和处理
直接返回 http.Error() 很方便，但不利于统一结构。建议定义一个错误类型，例如：
type HttpError struct { Code int `json:"code"` Message string `json:"message"` }
然后在整个项目中使用它来包装错误信息。比如：
func handleError(w http.ResponseWriter, err HttpError) { w.WriteHeader(err.Code) json.NewEncoder(w).Encode(err) }
这样做的好处是前后端可以约定一套错误码规范，也方便做自动化测试和日志分析。
在业务逻辑中主动抛出结构化错误
中间件负责兜底，但具体业务错误应该由代码主动触发。例如：
if user == nil { handleError(w, HttpError{ Code: http.StatusNotFound, Message: "User not found", }) return }
这种方式比到处写 http.Error() 更清晰，也更容易扩展。如果你用的是 Gin 这样的框架，还可以结合 c.AbortWithStatusJSON() 来更简洁地返回结构化错误。
结合中间件和自定义错误类型，让错误处理更优雅
你可以把上面两部分结合起来，在中间件里判断是否是 HttpError 类型，如果不是就当作未知错误处理。例如：
defer func() { if r := recover(); r != nil { if e, ok := r.(HttpError); ok { handleError(w, e) } else { handleError(w, HttpError{ Code: http.StatusInternalServerError, Message: "Unknown error", }) } } }()
这样一来，无论是程序 panic，还是业务逻辑主动抛错，都能被统一处理。
基本上就这些。关键点是：用中间件统一入口，用结构体统一输出，用中间层封装细节。这套模式在中小型项目中很实用，也不难维护。
