定义统一响应结构体Response包含Success、Message、Data和Code字段；2. 封装Error和Success函数用于返回标准化的错误和成功响应；3. 使用RecoverMiddleware中间件捕获panic并返回统一错误格式；4. 在Handler中通过Error函数返回各类业务错误，确保前后端交互一致性。
在Golang Web开发中，统一错误返回格式有助于前端更好地处理响应，提升接口的规范性和可维护性。下面是一个常见的统一错误返回示例，基于标准HTTP状态码和自定义业务错误码设计。
统一响应结构定义
定义一个通用的API响应结构体，包含成功标志、消息、数据和错误码：
type Response struct {
Success bool `json:"success"`
Message string `json:"message"`
Data interface{} `json:"data,omitempty"`
Code int `json:"code"`
}
Success 表示请求是否成功，Message 返回提示信息，Data 返回具体数据（成功时填充），Code 是业务或HTTP状态码。
错误响应封装函数
封装几个常用的返回方法，便于在Handler中调用：
立即学习“go语言免费学习笔记（深入）”；
func JSON(w http.ResponseWriter, statusCode int, data interface{}) {
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(statusCode)
json.NewEncoder(w).Encode(data)
}
func Error(w http.ResponseWriter, message string, code int) {
resp := Response{
Success: false,
Message: message,
Code: code,
}
JSON(w, code, resp)
}
func Success(w http.ResponseWriter, data interface{}, message string) {
resp := Response{
Success: true,
Message: message,
Data: data,
Code: http.StatusOK,
}
JSON(w, http.StatusOK, resp)
}
通过 Error 函数可以统一返回错误，避免散落在各处的错误处理逻辑。
中间件中捕获异常
使用中间件捕获未处理的panic，并返回统一错误格式：
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", err)
Error(w, "Internal server error", http.StatusInternalServerError)
}
}()
next.ServeHTTP(w, r)
})
}
将此中间件注册到路由中，可防止服务因panic而中断，并保证错误格式一致。
在Handler中使用示例
实际业务处理中，可以这样返回错误：
func GetUserHandler(w http.ResponseWriter, r *http.Request) {
// 模拟错误
if r.URL.Query().Get("id") == "" {
Error(w, "User ID is required", http.StatusBadRequest)
return
}
// 模拟查不到用户
user := getUserFromDB("123")
if user == nil {
Error(w, "User not found", http.StatusNotFound)
return
}
Success(w, user, "User retrieved successfully")
}
这样无论成功还是失败，前端收到的JSON结构都是一致的，便于统一处理。
基本上就这些。通过结构体+封装函数+中间件的方式，能有效实现Golang Web项目中的错误统一返回，提高代码整洁度和前后端协作效率。
