在 Gin 框架中，可通过 c.Errors 获取中间件链中后续处理器（如路由处理函数或 NoRoute/NoMethod 处理器）主动设置的错误，从而在 c.Next() 之后判断请求是否失败（如 404 路由未命中），实现统一错误响应、日志记录或降级逻辑。
在 gin 框架中，可通过 `c.errors` 获取中间件链中后续处理器（如路由处理函数或 noroute/nomethod 处理器）主动设置的错误，从而在 `c.next()` 之后判断请求是否失败（如 404 路由未命中），实现统一错误响应、日志记录或降级逻辑。
Gin 的 c.Next() 是同步调用，它会阻塞执行直至整个中间件链（含匹配的路由处理器）完成。但 c.Next() 本身不返回状态码或错误——Gin 将错误处理设计为“累积式”：通过 c.Error(err) 向上下文的 c.Errors（类型为 gin.Errors，底层是 []error）追加错误，而标准的 NoRoute 或 NoMethod 处理器正是我们捕获“未匹配路由”这类失败的关键入口。
因此，正确做法是：
- 在 NoRoute / NoMethod 处理器中显式调用 c.Error()，将语义化错误注入上下文；
- 在自定义中间件的 c.Next() 后检查 c.Errors，而非依赖 c.Writer.Status()（因响应可能已被写入，且状态码不等价于业务失败）。
以下是一个完整示例：
Miller CSV TSV JSON 数据处理器
下载
Miller (mlr) 是一个命令行工具，用于查询、整形和重新格式化名称索引数据，如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。
func RecoveryWithLogging() gin.HandlerFunc {
return func(c *gin.Context) {
// 请求前可执行预处理（如日志、指标）
startTime := time.Now()
c.Next() // 执行后续中间件及路由处理器
// c.Next() 返回后，检查是否有累积错误
if len(c.Errors) > 0 {
err := c.Errors.Last() // 获取最后添加的错误（通常最具代表性）
statusCode := http.StatusInternalServerError
if strings.Contains(err.Error(), "not allowed") ||
strings.Contains(err.Error(), "Failed to find route") {
statusCode = http.StatusNotFound
}
// 统一记录失败日志
log.Printf("[ERROR] %s %s → %d (%v)", c.Request.Method, c.Request.URL.Path, statusCode, err)
// 可选择在此终止响应（若尚未写入）
if !c.IsAborted() {
c.AbortWithStatusJSON(statusCode, gin.H{
"success": false,
"message": "Request failed",
"error": err.Error(),
})
}
return
}
// 无错误时记录成功耗时
log.Printf("[INFO] %s %s → %d (%v)", c.Request.Method, c.Request.URL.Path, c.Writer.Status(), time.Since(startTime))
}
}
// 必须注册 NoRoute 处理器并调用 c.Error()
r := gin.New()
r.Use(RecoveryWithLogging)
r.NoRoute(func(c *gin.Context) {
c.Error(fmt.Errorf("route not found: %s %s", c.Request.Method, c.Request.URL.Path))
c.JSON(http.StatusNotFound, gin.H{
"error": "API endpoint not found",
})
})
r.NoMethod(func(c *gin.Context) {
c.Error(fmt.Errorf("method not allowed: %s %s", c.Request.Method, c.Request.URL.Path))
c.JSON(http.StatusMethodNotAllowed, gin.H{
"error": "HTTP method not supported",
})
})
⚠️ 重要注意事项：
- c.Errors 仅包含显式调用 c.Error() 注入的错误，不会自动捕获 panic 或 HTTP 状态码；务必在 NoRoute/NoMethod 中主动调用 c.Error()；
- 若下游处理器已调用 c.Abort() 或写入响应（如 c.JSON），c.IsAborted() 将返回 true，此时不应再写入响应体，避免 http: multiple response.WriteHeader calls 错误；
- c.Errors.Last() 是安全获取最终错误的方式（c.Errors.Error() 已弃用，应避免使用）；
- 此模式适用于业务层失败感知，如权限拒绝、参数校验失败等，也可在对应处理器中调用 c.Error() 实现统一兜底。
通过该机制，你可在任意中间件中可靠地感知整个请求链的成败，构建健壮的可观测性与错误处理体系。
