设计全局错误处理器是为了统一错误格式、自动记录日志、提供恢复机制并避免重复代码。1. 定义标准错误结构体appError，包含code、message和err字段，并实现error()方法以符合error接口。2. 在web应用中使用中间件捕获http请求中的错误，通过defer recover处理panic，并统一返回json格式错误。3. 在非http场景下通过封装主函数逻辑或wrapper函数处理错误，结合recover和sync.waitgroup确保程序稳定性。关键点包括恢复panic、明确错误类型、记录完整日志以及不忽略任何error。
在写 golang 应用的时候，错误处理往往是容易被忽略但又非常关键的一环。很多人刚开始写代码时都是直接
就完了，但随着项目变大，你会发现到处是重复的错误判断、日志记录和返回逻辑。这时候就需要一个全局的错误处理器来统一管理这些操作。
为什么要设计全局错误处理器？
Go 的错误处理机制不同于其他语言（比如 Java 的 try-catch），它是显式的，每个函数调用都可能返回 error。如果不做统一处理，整个应用的错误逻辑会分散在各个地方，维护起来很麻烦。
设计一个全局错误处理器的目标是：
立即学习“go语言免费学习笔记（深入）”；
- 统一错误格式输出
- 自动记录日志
- 提供恢复机制（例如 panic 捕获）
- 避免重复代码
如何构建一个全局错误处理器？
1. 定义标准错误结构体
为了统一错误响应格式，你可以先定义一个标准的错误结构体，比如：
type AppError struct { Code int `json:"code"` Message string `json:"message"` Err error `json:"-"` }
然后实现
Error()
方法让它符合
error
接口：
func (e *AppError) Error() string { return e.Err.Error() }
这样你就可以在整个应用中使用
*AppError
类型来传递错误信息了。
2. 使用中间件捕获 HTTP 请求中的错误
如果你在开发 Web 应用，可以在中间件中统一处理错误。比如在 gin 或 echo 这样的框架中，可以创建一个封装函数，拦截所有 handler 中的 panic 并处理 error 返回。
以 Gin 为例：
func ErrorHandlerMiddleware() gin.HandlerFunc { return func(c *gin.Context) { defer func() { if r := recover(); r != nil { // 处理 panic，转换为 AppError var appErr *AppError switch t := r.(type) { case string: appErr = &AppError{Code: 500, Message: "Internal Server Error", Err: errors.New(t)} case error: appErr = &AppError{Code: 500, Message: "Internal Server Error", Err: t} default: appErr = &AppError{Code: 500, Message: "Unknown error", Err: errors.New("unknown")} } c.AbortWithStatusJSON(appErr.Code, appErr) } }() c.Next() // 处理正常返回的 error for _, err := range c.Errors { if appErr, ok := err.Err.(*AppError); ok { c.AbortWithStatusJSON(appErr.Code, appErr) return } } } }
这样无论是手动返回的 error，还是 panic 触发的异常，都能被捕获并统一返回给客户端。
3. 在非 HTTP 场景下统一处理错误
不是所有的 Go 程序都是 Web 服务，有些是后台任务或 CLI 工具。这时可以通过封装主函数逻辑或者使用 wrapper 函数来统一处理错误。
举个例子：
func Run() error { // 主程序逻辑 if err := doSomething(); err != nil { return &AppError{Code: 400, Message: "Failed to do something", Err: err} } return nil } func main() { if err := Run(); err != nil { log.Printf("Error: %+v", err) os.Exit(1) } }
如果涉及 goroutine，建议配合
recover
和
sync.WaitGroup
来确保不会因为 panic 导致整个进程崩溃。
错误恢复机制的几个关键点
- panic 要 recover：在并发或中间件中尤其重要，避免一次 panic 把整个服务搞挂。
- 错误类型要明确：自定义错误结构体有助于区分不同类型的错误，比如数据库错误、参数错误等。
- 日志记录不能少：不管是否返回给客户端，都要记录完整的错误信息，方便排查问题。
- 不要忽略 error：即使你不打算处理某个错误，至少也要记录下来，防止未来踩坑。
基本上就这些。设计一个良好的错误处理器并不复杂，但它能大大提升系统的可维护性和稳定性。只要一开始就把结构搭好，后面加功能也不难。
