Fiber开启Gzip压缩唯一推荐方式是app.Use(compress.New()),需置于路由注册前;默认压缩≥1024B、MIME在白名单内且非204/304/404响应,禁用显式Content-Length,生产环境前置nginx时应关闭此中间件。

compress.New() 是 Fiber 开启 Gzip 压缩的唯一推荐方式,不需要手动调用 gzip.Writer,也不需要预生成 .gz 文件——它是运行时动态压缩,开箱即用。
必须在 app.Use() 中注册,且顺序不能错
中间件注册位置直接影响是否生效:compress.New() 必须放在所有路由注册之前,否则匹配不到响应体。
- ✅ 正确:先
app.Use(compress.New()),再app.Get(...) - ❌ 错误:把
Use()放在app.Listen()之后,或夹在两个路由中间 - ⚠️ 注意:Fiber 不会报错,但压缩完全不触发——现象是响应头始终没有
Content-Encoding: gzip
为什么有些接口没被压缩?三个高频原因
即使请求带了 Accept-Encoding: gzip,响应仍可能原样返回。最常见原因:
- 显式设置了
Content-Length(比如c.Set("Content-Length", "123"))→ Fiber 主动跳过压缩,避免长度错乱 - MIME 类型不在白名单内(默认只含
text/.*、application/json、application/javascript等)→ 比如你返回application/vnd.api+json,就得自定义compress.Config{Enable: func(c *fiber.Ctx) bool { ... }} - 状态码为
204、304或404→ Fiber 默认跳过这些无正文或协商响应的压缩
compress.New() 的参数怎么调?别盲目设最高级
压缩级别影响 CPU 占用和响应延迟,不是越高越好:
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
- 默认是
gzip.DefaultCompression(值为6),平衡压缩率与性能 - 可选范围是
-2到9:-2(gzip.NoCompression)≈ 不压,9(gzip.BestCompression)CPU 消耗明显上升 - 生产环境若已部署
nginx,应禁用 Fiber 的compress.New(),改由 nginx 统一处理——重复压缩不仅浪费 CPU,还可能因 header 冲突导致响应异常
小响应不压缩是设计行为,不是 bug
Fiber 默认只压缩 ≥1024 字节的响应体。这是合理策略:
立即学习“go语言免费学习笔记(深入)”;
- 小文本(如
{"ok":true})压缩后体积可能反而变大,还多一次 CPU 运算 - 无法通过配置关闭该阈值,硬要压小响应需自定义
compress.Config{Level: ..., MinSize: 0}(但不建议) - 验证是否生效,别只看响应体大小——重点检查响应头是否有
Content-Encoding: gzip和Vary: Accept-Encoding
Content-Length 和前置反向代理共存场景——这两处一旦出问题,压缩就静默失效,连错误提示都没有。

















