在goframe框架中捕获和统一处理全局异常,核心做法是在应用启动时通过 ghttp.server.setbindaddr 或更常用的 ghttp.server.seterrorhandler 注册一个全局错误处理函数。该函数接收请求上下文 *ghttp.request 和错误对象 error,你可以在其中记录日志、格式化响应并直接写入http状态码与json体,从而拦截所有未处理的panic或业务抛出的错误。

如何自定义错误返回的JSON结构
要实现统一的JSON返回格式,需要在错误处理函数中判断错误类型,如果是业务逻辑错误则提取错误码和消息,如果是系统级错误则使用默认的错误码。通过 r.Response.WriteJsonExit() 方法可以发送JSON响应并立即终止后续中间件的执行,确保响应格式的一致性。

package main
import (
"github.com/gogf/gf/v2/frame"
"github.com/gogf/gf/v2/net/ghttp"
"github.com/gogf/gf/v2/os/glog"
)
type Response struct {
Code int `json:"code"`
Message string `json:"message"`
Data interface{} `json:"data,omitempty"`
}
func main() {
s := frame.Core().Server()
// 设置全局错误处理器
s.SetErrorHandler(func(r *ghttp.Request, err error) {
// 记录错误日志
glog.Error(err)
// 定义默认响应
resp := Response{
Code: 500,
Message: "Internal Server Error",
}
// 尝试从错误中提取业务信息(假设使用了 gferr)
if gfErr, ok := err.(*gferr.Error); ok {
resp.Code = gfErr.Code
resp.Message = gfErr.Message
} else {
// 对于非业务错误,可以根据需要调整
resp.Message = err.Error()
}
// 写入JSON响应并退出
r.Response.WriteJsonExit(resp)
})
s.BindHandler("/test", func(r *ghttp.Request) {
// 模拟抛出错误
panic("simulated panic")
})
s.Run()
}
当访问 /test 接口时,预期结果为:
{"code":500,"message":"simulated panic"}
如何处理特定类型的业务异常
除了全局捕获,通常还需要区分业务异常和系统异常。可以通过定义自定义错误类型或使用 gferr.New() 创建携带错误码的错误。在中间件或路由处理函数中抛出这些特定错误,全局处理器就能根据错误类型返回不同的HTTP状态码(如400表示参数错误,404表示资源不存在)。

package main
import (
"github.com/gogf/gf/v2/frame"
"github.com/gogf/gf/v2/net/ghttp"
"github.com/gogf/gf/v2/os/glog"
"github.com/gogf/gf/v2/errors/gerr"
)
type BusinessException struct {
Code int
Message string
}
func (e *BusinessException) Error() string {
return e.Message
}
func main() {
s := frame.Core().Server()
s.SetErrorHandler(func(r *ghttp.Request, err error) {
glog.Error(err)
resp := Response{Code: 500, Message: "Internal Server Error"}
// 检查是否为业务异常
if bizErr, ok := err.(*BusinessException); ok {
resp.Code = bizErr.Code
resp.Message = bizErr.Message
// 根据错误码设置HTTP状态
if bizErr.Code == 400 {
r.Response.Status = 400
} else if bizErr.Code == 404 {
r.Response.Status = 404
}
}
r.Response.WriteJsonExit(resp)
})
s.BindHandler("/biz-error", func(r *ghttp.Request) {
// 抛出业务异常
panic(&BusinessException{Code: 400, Message: "Invalid Input"})
})
s.Run()
}
当访问 /biz-error 接口时,预期结果为:
{"code":400,"message":"Invalid Input"}
基于程序中某个输入、条件或结果的具体问题
如果程序中没有抛出任何错误,而是正常返回数据,全局错误处理器不会被触发。此时,如果需要统一包装成功响应,可以使用中间件而非错误处理器。例如,在所有路由执行后,检查响应内容并添加时间戳或签名。











