必须在next(c)执行后调用c.response().status()获取真实状态码，因该值默认为0且仅在writeheader或首次write后更新；若需统一捕获所有404，还需注册自定义httperrorhandler处理未匹配路由情形。
中间件里怎么拿到响应状态码
Echo 的 echo.Context 本身不暴露已写入的 HTTP 状态码，因为响应可能还没真正写出（比如被后续中间件拦截或重定向）。必须在 echo.HTTPErrorHandler 或响应写入钩子中捕获——但 Echo v4+ 提供了更直接的方式：c.Response().Status 在写响应后才有效，所以得用 echo.MiddlewareFunc 包裹写响应逻辑，或监听 echo.HTTPErrorHandler 的调用时机。
推荐做法是使用 echo.WrapMiddleware + 自定义包装器，在 next(c) 后读取 c.Response().Status()：
func StatusCodeLogger() echo.MiddlewareFunc {
return func(next echo.Handler) echo.Handler {
return echo.HandlerFunc(func(c echo.Context) error {
err := next(c)
status := c.Response().Status()
// 这里 status 是实际写入的状态码（如 200、404、500）
log.Printf("path=%s status=%d", c.Request().URL.Path, status)
return err
})
}
}
为什么不能在 next() 前读取 c.Response().Status()
因为 c.Response().Status() 返回的是当前响应缓冲区记录的状态码，默认是 0；只有 WriteHeader() 或首次 Write() 被调用后才会更新。中间件执行时，下游 handler 可能尚未调用 c.String()、c.JSON() 等方法，此时读取到的永远是 0。
- 常见错误：在
next(c)前打印c.Response().Status()→ 总输出0 - 正确时机：必须在
next(c)返回后，且 handler 已完成响应写入 - 例外情况：如果 handler panic 或被
HTTPErrorHandler拦截，Status()可能仍为 0，需结合err != nil判断
如何区分 404 是路由未匹配还是业务返回
Echo 的 404 分两类：一类是框架自动返回（无匹配路由），另一类是 handler 主动调用 c.NoContent(404) 或 c.String(404, ...)。前者不会触发你的中间件中的 next(c)（因为没路由对应 handler），后者会。
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
要统一统计所有 404，必须注册自定义 HTTPErrorHandler：
e.HTTPErrorHandler = func(err error, c echo.Context) {
if he, ok := err.(*echo.HTTPError); ok {
log.Printf("http_error path=%s code=%d", c.Request().URL.Path, he.Code)
c.Logger().Error(err)
c.JSON(he.Code, map[string]string{"error": he.Message})
} else {
log.Printf("unknown_error path=%s err=%v", c.Request().URL.Path, err)
c.String(http.StatusInternalServerError, "Internal Server Error")
}
}
注意：这个 errorHandler 不影响你原有中间件对正常流程状态码的统计，但能补全“未命中路由”这类 404。
性能和并发要注意什么
状态码统计本身开销极小，但日志 I/O 或上报逻辑（如发 Kafka、调远程 API）容易成为瓶颈。尤其在高 QPS 场景下：
- 避免在中间件里做阻塞操作（如同步 HTTP 上报、文件写入）
- 状态码聚合建议用原子计数器（
sync/atomic）或带缓冲 channel 异步处理 - 不要在每个请求里 new struct 或 fmt.Sprintf —— 预分配日志字段或用
log.WithField()（如果用 logrus） - Echo 的
c.Response().Status()是线程安全的，无需额外锁
最常被忽略的是 errorHandler 和中间件重复统计：比如一个 404 请求既进了 errorHandler，又被中间件捕获（如果它确实匹配了某个路由但 handler 内部返回 404），这时需按业务语义决定是否去重。
