默认Echo日志中间件不适合生产环境，因其基于标准库log，不支持结构化日志、动态字段注入、分级写入及高并发锁优化；Zap以零分配设计实现3–5倍吞吐提升，需绕过echo.Logger，通过自定义中间件和HTTPErrorHandler集成。
为什么默认的Echo日志中间件不适合生产环境
因为 echo.Logger 基于标准库 log，不支持结构化日志、字段动态注入、日志等级分级写入不同文件，且在高并发下存在锁竞争问题。Zap 提供了零分配（zero-allocation）的 Logger 和 SugaredLogger，吞吐量比标准库高 3–5 倍，这才是生产级日志的起点。
如何用 Zap 替换 Echo 的默认日志中间件
关键不是“替换”，而是绕过 echo.Logger，直接把 Zap 实例注入到 echo.HTTPErrorHandler 和自定义中间件中。Echo 的 Use() 不接受 Zap 实例，必须自己封装中间件函数：
func ZapLogger(zapLogger *zap.Logger) echo.MiddlewareFunc {
return func(next echo.HandlerFunc) echo.HandlerFunc {
return func(c echo.Context) error {
start := time.Now()
if err := next(c); err != nil {
zapLogger.Error("request failed",
zap.String("path", c.Request().URL.Path),
zap.String("method", c.Request().Method),
zap.String("error", err.Error()),
zap.Duration("duration", time.Since(start)))
return err
}
zapLogger.Info("request completed",
zap.String("path", c.Request().URL.Path),
zap.String("method", c.Request().Method),
zap.Int("status", c.Response().Status),
zap.Duration("duration", time.Since(start)))
return nil
}
}
}
- 不要调用
c.Logger()，它返回的是 Echo 自带的 logger，和 Zap 无关 - 路径和状态码必须从
c.Request()和c.Response()显式取，不能依赖上下文键（c.Get()）传递，避免中间件顺序依赖 - 错误日志必须在
err != nil分支里记录，否则 panic 会跳过中间件
Zap 日志级别与 Echo 错误处理怎么对齐
Echo 的 HTTPErrorHandler 是统一错误出口，但默认只传 error 和 echo.Context，无法区分是业务错误（warn）、参数校验失败（info）还是系统 panic（error）。需要手动增强：
Echo框架 5.1.0
下载
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
e.HTTPErrorHandler = func(err error, c echo.Context) {
status := http.StatusInternalServerError
if he, ok := err.(*echo.HTTPError); ok {
status = he.Code
}
switch status {
case http.StatusBadRequest, http.StatusUnauthorized, http.StatusForbidden:
zapLogger.Warn("client error",
zap.Int("status", status),
zap.String("path", c.Request().URL.Path),
zap.Error(err))
case http.StatusInternalServerError:
zapLogger.Error("server error",
zap.Int("status", status),
zap.String("path", c.Request().URL.Path),
zap.Error(err))
default:
zapLogger.Info("http error",
zap.Int("status", status),
zap.String("path", c.Request().URL.Path),
zap.Error(err))
}
c.JSON(status, map[string]string{"error": err.Error()})
}
- 必须用
*echo.HTTPError类型断言，不能只看err.Error()字符串匹配 -
zap.Error()会自动展开堆栈（如果 err 实现了fmt.Formatter），但 panic 需要额外捕获：在HTTPErrorHandler外层加defer/recover并调用zapLogger.DPanic() - 不要在
HTTPErrorHandler里调用c.Logger().Error()，会造成双写
文件轮转和异步写入要注意什么
Zap 本身不内置轮转，得靠 lumberjack.Logger 包桥接；而异步写入（zapcore.NewCore + zapcore.NewSamplerCore）虽能降延迟，但会丢失最后几条日志（进程崩溃时）。生产环境建议折中：
立即学习“go语言免费学习笔记（深入）”；
- 用
lumberjack.Logger配置MaxSize（如 100MB）、MaxBackups（如 5）、MaxAge（如 7），并设LocalTime: true - 核心写入器用
zapcore.AddSync()包一层，不要直接传os.Stdout—— 否则lumberjack的 Close() 会失效 - 采样（sampling）只对 debug/info 级别开启，error/warn 级别禁用，避免关键错误被丢弃
- 日志目录权限必须提前创建好，Zap 不会自动建多级目录，
os.MkdirAll()要在zap.NewProductionConfig()之前执行
最易被忽略的是：Zap 的 Sync() 方法必须显式调用（比如在 signal.Notify 捕获 SIGTERM 后），否则进程退出时缓冲区日志会丢失。
