go http中间件捕获自定义错误需主动暴露错误:gin依赖panic+recover或手动abort,echo则通过handlerfunc返回error触发httperrorhandler;统一用apperror类型封装状态码与消息,并在中间件中类型断言处理。

Go HTTP中间件怎么捕获并处理自定义错误
Go 的 net/http 本身不带错误传播机制,HTTP handler 返回值只有 error 类型,但框架(如 Gin、Echo)也不自动拦截它——你写的 return errors.New("xxx") 不会触发任何错误处理逻辑,只会被忽略或变成 500 响应体里的空内容。
真正起作用的是「主动 panic」+ 框架的 recover 中间件,或者手动在每个 handler 里调用 c.AbortWithStatusJSON / c.Echo().HTTPErrorHandler 等显式出口。所以不是“能不能捕获”,而是“你得让错误走到框架能感知的路径上”。
- Gin 默认只 recover
panic,不处理返回的error;想用返回值驱动错误响应,必须自己写中间件检查c.Errors或约定返回error后调用c.Abort() - Echo 更明确:
HandlerFunc签名是func(c echo.Context) error,返回非 nilerror会进echo.HTTPErrorHandler,但前提是没提前c.JSON或c.String - 别在 handler 里用
log.Fatal或直接os.Exit(1),这会让整个服务挂掉,不是“拦截错误”,是制造雪崩
Gin 中用 CustomError 实现分类响应
硬编码 if err != nil { c.JSON(400, "bad request") } 很容易漏状态码、重复逻辑。推荐定义一个可序列化的错误类型,比如:
type AppError struct {
Code int `json:"code"`
Message string `json:"message"`
}
func (e *AppError) Error() string { return e.Message }
然后在中间件里统一判断:
立即学习“go语言免费学习笔记(深入)”;
- 在 handler 中返回
&AppError{Code: 404, Message: "user not found"} - 中间件用
if appErr, ok := err.(*AppError); ok { c.JSON(appErr.Code, appErr) } - 注意:Gin 的
c.Error(err)只是把 err 存到c.Errors,不会自动触发响应,必须自己读取并处理 - 别把
AppError嵌入标准error接口以外的结构(比如加func(e *AppError) StatusCode() int),Gin 不识别,徒增耦合
Echo 的 HTTPErrorHandler 怎么区分业务错误和 panic
Echo 的 e.HTTPErrorHandler = func(err error, c echo.Context) 是唯一入口,但它要同时处理三类东西:handler 返回的 error、中间件 panic、c.Bind() 失败等框架内部错误。全塞一起处理容易误判。
- 用类型断言区分:比如
if _, ok := err.(*json.UnmarshalTypeError); ok { ... }是解析错误,该 400;而if _, ok := err.(*AppError); ok { ... }是业务错误,按字段设状态码 - 对 panic,Echo 会包装成
*echo.HTTPError,其Code默认是 500,但你可以用recover()拿到原始 panic 值再做判断 - 别在
HTTPErrorHandler里再调c.JSON—— 如果上下文已提交(header 已发),会 panic 报"http: response.WriteHeader on hijacked connection" - 建议开头加
if c.Response().Committed { return }防止重复写响应
中间件里 abort 和 return 的执行顺序陷阱
很多人以为 c.Abort() 就等于“退出当前请求”,其实它只是标记后续中间件跳过,并不中断当前函数执行。如果 handler 里写了 c.JSON(200, data); c.Abort(); return,漏掉 return 就可能接着跑后续代码,甚至二次写 body。
- Gin 中:
c.Abort()后必须return,否则下一行仍执行;c.AbortWithStatusJSON(400, err)内部已含Abort()和JSON(),但仍需return - Echo 中:
c.NoContent(400)不会自动终止 handler,同样要return;但return err会交由HTTPErrorHandler,此时不能再写响应 - 最稳妥写法:所有错误分支末尾都加
return,哪怕看起来“后面没代码了”——Go 编译器不会帮你补
业务错误不是靠框架自动发现的,是你在哪个环节把它暴露给框架、用什么格式表达、以及有没有阻断后续流程——这三个动作缺一不可。最容易被跳过的,是那个小小的 return。










