设计全局错误处理器是为了统一错误格式、自动记录日志、提供恢复机制并避免重复代码。1. 定义标准错误结构体apperror，包含code、message和err字段，并实现error()方法以符合error接口。2. 在web应用中使用中间件捕获http请求中的错误，通过defer recover处理panic，并统一返回json格式错误。3. 在非http场景下通过封装主函数逻辑或wrapper函数处理错误，结合recover和sync.waitgroup确保程序稳定性。关键点包括恢复panic、明确错误类型、记录完整日志以及不忽略任何error。
在写 Golang 应用的时候，错误处理往往是容易被忽略但又非常关键的一环。很多人刚开始写代码时都是直接
if err != nil就完了，但随着项目变大，你会发现到处是重复的错误判断、日志记录和返回逻辑。这时候就需要一个全局的错误处理器来统一管理这些操作。
为什么要设计全局错误处理器？
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：即使你不打算处理某个错误，至少也要记录下来，防止未来踩坑。
基本上就这些。设计一个良好的错误处理器并不复杂，但它能大大提升系统的可维护性和稳定性。只要一开始就把结构搭好，后面加功能也不难。
