直接用 middleware.Gzip() 即可,必须作为全局中间件注册(e.Use(middleware.Gzip())),不可在 handler 内手动设头或压缩,它默认压缩 text/*、application/json 等类型且响应体 ≥1KB 的内容。

直接用 middleware.Gzip() 就行,但别在 handler 里手动压缩
Echo 的 Gzip 压缩必须作为中间件注册,不能在某个 GET 或 POST 路由 handler 里调用 gzencode 或写 Content-Encoding: gzip 头——那样只会导致响应体被双重编码或浏览器解压失败。中间件会在 WriteHeader 和 Write 调用前统一拦截、压缩并设置正确头信息。
正确做法是全局启用:
e := echo.New() e.Use(middleware.Gzip())
它默认对 text/*、application/json、application/javascript 等 MIME 类型生效,且只压缩响应体大于 1KB 的内容(避免小响应因 gzip header 开销反而变大)。
GzipWithConfig 怎么调?Level 和 Skipper 是关键参数
默认压缩等级是 -1(由 Go 标准库 gzip.BestSpeed 决定),实际约等于 level 1;若想平衡速度与压缩率,设为 5 更合理:
e.Use(middleware.GzipWithConfig(middleware.GzipConfig{
Level: 5,
}))
常见误配点:
-
Level超出范围(0–9)会 panic,不是静默忽略 -
Skipper函数返回true时跳过压缩,常用于排除图片、PDF 等本就压缩过的二进制响应:func(c echo.Context) bool { return strings.HasPrefix(c.Response().Header().Get("Content-Type"), "image/") } - 不要在
Skipper里读取c.Request().Body—— body 可能已被中间件提前消费,导致后续 handler 读不到数据
为什么有些接口没被压缩?检查 Content-Type 和响应长度
Gzip 中间件不压缩所有响应,它有硬性过滤逻辑:
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
- 响应状态码是
204、304时不压缩(RFC 规定) -
Content-Length为 0 或未设置时,且响应体为空,跳过 - 实际响应体字节数
(1KB)默认跳过——这是防小响应膨胀的关键策略 -
Content-Type不在白名单内(如application/octet-stream、video/mp4)也不会压缩
调试时可临时加个日志中间件确认:
e.Use(func(next echo.Handler) echo.Handler {
return func(c echo.Context) error {
// 在 next 前看不到 body 长度,只能在后钩子里看
rw := c.Response()
origWrite := rw.Write
rw.Write = func(p []byte) (int, error) {
log.Printf("Gzip candidate: %d bytes, type=%s", len(p), rw.Header().Get("Content-Type"))
return origWrite(p)
}
return next(c)
}
})
和 Nginx 的 gzip 冲突吗?通常不用共存
如果前端已部署 Nginx 并开启了 gzip on,再在 Echo 层叠一层 middleware.Gzip() 很可能造成重复压缩:Nginx 收到带 Content-Encoding: gzip 的响应后,可能直接透传而不解压,最终客户端收到 gzip 套 gzip 的乱码。
推荐策略:
- 纯 Echo 部署(无反向代理)→ 启用
middleware.Gzip() - 前置 Nginx → 关掉 Echo 的 Gzip,让 Nginx 统一处理;同时确保 Nginx 的
gzip_types包含application/json等 API 常用类型 - 必须双层压缩的极少数场景(如某些 CDN 要求源站输出 gzip)→ 需显式设置
Skipper排除已被 Nginx 压缩的路径,否则无法控制粒度
最易被忽略的是:Gzip 中间件对 streaming 响应(比如 c.Stream() 或分块写入)不生效——它依赖一次性获取完整响应体,流式场景得换方案。










