答案：Go语言通过返回error类型处理错误，需主动检查并统一响应格式如{"code":400,"message":"参数校验失败","details":"email字段不能为空"}；封装writeError函数标准化输出；使用recover中间件捕获panic避免服务中断；按层区分错误类型，定义ValidationError等自定义错误并判断处理；记录完整日志但对外仅返回通用提示，控制敏感信息泄露。
在Go语言开发Web服务时，错误处理是构建稳定接口的关键环节。Golang没有异常机制，而是通过返回error类型来传递错误信息，因此需要开发者主动检查和处理。合理的错误处理不仅能提升系统健壮性，还能让客户端更清晰地理解问题所在。
统一错误响应格式
为了便于前端解析和日志追踪，建议定义统一的错误响应结构。这样无论发生何种错误，客户端都能以一致的方式处理。
例如可以定义如下结构体：
{
"code": 400,
"message": "参数校验失败",
"details": "email字段不能为空"
}
在代码中可封装一个错误响应函数：
立即学习“go语言免费学习笔记（深入）”；
func writeError(w http.ResponseWriter, code int, message, details string) {
w.Header().Set("Content-Type", "application/json; charset=utf-8")
w.WriteHeader(code)
json.NewEncoder(w).Encode(map[string]interface{}{
"code": code,
"message": message,
"details": details,
})
}
中间件集中处理 panic 和未知错误
HTTP处理器中可能因空指针、数组越界等问题触发panic，导致服务中断。使用中间件可捕获这些运行时错误，避免程序崩溃。
实现一个recover中间件：
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\n", err)
writeError(w, 500, "服务器内部错误", "")
}
}()
next.ServeHTTP(w, r)
})
}
将此中间件包裹在路由处理链中，就能确保即使出现panic也能返回友好提示。
分层错误处理与自定义错误类型
在复杂项目中，建议按层级区分错误来源。比如数据库查询失败、业务逻辑校验不通过、第三方API调用异常等应有不同处理方式。
可以定义特定错误类型用于判断：
type ValidationError struct {
Field string
Message string
}
func (e ValidationError) Error() string {
return fmt.Sprintf("validation error on field %s: %s", e.Field, e.Message)
}
在处理函数中判断错误类型并返回对应状态码：
if err != nil {
var ve ValidationError
if errors.As(err, &ve) {
writeError(w, 400, "参数错误", ve.Message)
return
}
writeError(w, 500, "服务器错误", "")
return
}
记录日志并控制敏感信息输出
错误发生时应记录详细日志，但返回给客户端的信息需谨慎。不要暴露堆栈、数据库语句或内部路径。
推荐做法：
- 服务端记录完整错误和调用链
- 对外仅返回通用提示，如“操作失败，请稍后重试”
- 为每个错误生成唯一ID，便于排查时关联日志
基本上就这些。关键是保持错误处理的一致性和安全性，既不让用户困惑，也不让系统裸奔。
