定义统一响应结构体包含code、message、data字段，通过writeError/writeSuccess函数封装错误与成功响应，结合RecoveryMiddleware中间件捕获panic，确保所有错误返回格式一致，提升API可维护性与前端处理效率。
在构建 Golang 网络服务时，统一错误响应格式能提升 API 的可维护性和前端处理的一致性。核心思路是定义标准的响应结构，在发生错误时通过中间件或封装函数返回统一格式的 JSON 响应。
定义统一响应结构
创建一个通用的响应结构体，包含状态码、消息和数据字段：
type Response struct {
Code int `json:"code"`
Message string `json:"message"`
Data interface{} `json:"data,omitempty"`
}
使用 omitempty 可确保没有数据时该字段不出现，使响应更简洁。
封装错误响应函数
在 handler 中避免直接写 JSON，而是通过工具函数返回标准化错误：
立即学习“go语言免费学习笔记（深入）”；
func writeError(w http.ResponseWriter, code int, message string) {
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(code)
json.NewEncoder(w).Encode(Response{
Code: code,
Message: message,
})
}
func writeSuccess(w http.ResponseWriter, data interface{}) {
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(http.StatusOK)
json.NewEncoder(w).Encode(Response{
Code: 0,
Message: "success",
Data: data,
})
}
结合中间件自动处理 panic 和错误
使用中间件捕获未处理的 panic，并转换为统一错误响应：
触网万能商城建站系统免费版
下载
触网万能商城系统，3年专注打磨一款产品，专为网络服务公司、建站公司、威客、站长、设计师、网络运营及营销人员打造，是一款超级万能建站利器，彻底告别代码编程和找模板，改模板，改代码的低效高成本方式，仅需一个人可服务无数客户，系统集万能官网+万能商城+万能表单+博客+新闻+分销...于一体，通过海量模块拖拽布局、万能组合和超级自定义功能，可以构建各种类型的响应式网站。
func RecoveryMiddleware(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)
writeError(w, http.StatusInternalServerError, "internal server error")
}
}()
next.ServeHTTP(w, r)
})
}
将中间件应用于路由，确保所有请求都受保护。
在业务逻辑中主动返回错误
handler 中根据业务判断调用 writeError：
http.HandleFunc("/user", func(w http.ResponseWriter, r *http.Request) {
if r.Method != "GET" {
writeError(w, http.StatusMethodNotAllowed, "method not allowed")
return
}
// 正常逻辑
writeSuccess(w, map[string]string{"name": "alice"})
})
这样无论参数校验、权限检查还是数据库错误，都能以相同格式返回。
基本上就这些。关键在于集中处理响应逻辑，避免散落在各处，同时配合中间件兜底，保证错误不会暴露内部细节。统一结构也便于前端统一拦截处理。
