Go通过返回error处理错误，需设计统一响应格式如{"code":400,"message":"参数校验失败","details":"缺少必填字段email"}，并封装writeError函数输出；使用recover中间件捕获panic防止服务崩溃；采用分层架构，各层职责分明，service返回自定义AppError，handler转换为HTTP错误；结合zap等结构化日志记录上下文，并集成Prometheus或Sentry实现监控告警，确保系统稳定。
在Go语言开发Web服务时，正确处理请求异常与错误是保障系统稳定性和可维护性的关键。不同于其他语言的try-catch机制，Go通过返回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,
})
}
中间件捕获全局异常
Go的HTTP处理器中如果发生panic，会导致整个服务崩溃。使用中间件可以在请求处理链中recover异常，避免程序退出。
实现一个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。
wechat-article-extraction-mp-weixin-qq-com news-webpage-cleaning blog-post-parsing metadata-extraction-title-author-date multiple-output-formats-markdown-json-plain-text batch-processing-support
下载
基于三引擎设计，从微信文章、新闻和博客网页提取干净内容，支持标题作者日期元数据，多格式和批量处理。
分层错误处理策略
在实际项目中，通常采用分层架构（如handler、service、dao）。每一层应有明确的职责：
- Handler层：负责验证输入参数、调用service并处理业务错误
- Service层：执行核心逻辑，返回领域相关的错误（如用户不存在、余额不足）
- Data层：处理数据库连接、查询失败等底层异常
对于不同类型的错误，应做适当转换。比如数据库超时不应直接暴露给前端，而应转为“系统繁忙”。
可以自定义错误类型：
type AppError struct {
Code int
Message string
}
func (e AppError) Error() string {
return e.Message
}
在service中返回特定错误，在handler中识别并转化为HTTP响应。
日志记录与监控集成
错误发生时，必须记录足够的上下文信息用于排查。建议记录请求路径、方法、客户端IP、时间戳及错误堆栈。
使用结构化日志库如zap或logrus，便于后续分析：
logger.Error("request failed",
zap.String("method", r.Method),
zap.String("url", r.URL.String()),
zap.String("ip", r.RemoteAddr),
zap.Error(err))
结合Prometheus或Sentry等工具，还可实现错误告警和趋势分析。
基本上就这些。Go的错误处理虽无异常机制，但通过清晰的分层、统一的响应和完善的日志，完全可以构建健壮的Web服务。关键是保持一致性，让每个开发者都遵循相同的规范。不复杂但容易忽略。
