Fiber本身不处理Gzip压缩,必须由Nginx/Apache等Web服务器完成或使用@fiber/compress中间件;后者仅适用于非流式、非文件类动态响应,且需正确配置Level、Skipper并避免与c.Set()冲突。

Fiber 本身不处理 Gzip 压缩,必须交由 Web 服务器(Nginx/Apache)或使用 @fiber/compress 中间件 —— 但后者仅适用于动态响应,且有明确限制
为什么不能直接在 Fiber 里“开个开关”就启用 Gzip?
Fiber 是基于 fasthttp 的框架,它不依赖 PHP 那类输出缓冲机制,也不内置 HTTP 传输层压缩逻辑。Gzip 压缩本质发生在响应体写入 TCP 连接前,而标准做法是:
- Web 服务器(如 Nginx)在转发响应前完成压缩(推荐,高效、可控)
- 应用层手动压缩(如用
@fiber/compress)—— 仅对非流式、非文件下载类响应有效 - 手动调用
gzip.NewWriter并设置Content-Encoding: gzip头 → 容易漏掉Vary: Accept-Encoding,导致 CDN 缓存污染
@fiber/compress 中间件怎么配才不踩坑?
这是 Fiber 官方提供的压缩中间件,但它不是“全局一开就灵”的工具,配置错就等于没开:
-
compress.Config.Level默认是6,别设成9—— CPU 开销陡增,高并发下延迟反升 -
compress.Config.Skipper必须显式排除二进制响应:比如Content-Type包含application/pdf、image/、application/zip的路由,否则浏览器打不开文件 - 它对
Stream类型响应(如c.Stream)和File类型(如c.File)完全无效 —— 中间件不会拦截或重写这些底层写操作 - 若你用了
c.Attachment()或c.SendFile(),压缩中间件自动跳过,无需额外 skip
示例正确用法:
app.Use(compress.New(compress.Config{
Level: compress.LevelBestSpeed,
Skipper: func(c *fiber.Ctx) bool {
ct := c.Get("Content-Type")
return strings.Contains(ct, "application/pdf") ||
strings.HasPrefix(ct, "image/") ||
c.Path() == "/health"
},
}))
Nginx 层压缩比 Fiber 中间件更可靠,配置时注意这三点
绝大多数生产环境应优先走 Nginx 压缩,因为:
- 不消耗 Go 进程 CPU,压缩在 epoll 就绪后、发包前完成
- 能统一处理静态资源(.js.gz/.css.gz)和动态响应(HTML/JSON)
- 支持
gzip_static on,自动命中预构建的 .gz 文件,零运行时压缩开销
关键配置项(放在 server 块内,**不要放 http 全局块**):
-
gzip on:必须开启 -
gzip_vary on:强制加Vary: Accept-Encoding头,避免反向代理缓存混乱 -
gzip_types至少包含:text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript——application/vnd.api+json这类自定义类型要手动加,否则 JSON API 不会被压
验证压缩是否生效,别只看响应头
常见误判:
- 看到
Content-Encoding: gzip就以为成功 → 实际可能是浏览器 DevTools 自动解压后显示的原始内容大小 - curl -H "Accept-Encoding: gzip" 看到响应体乱码 → 正常,说明压缩已生效,需用
gunzip解压验证
可靠验证方式:
- Chrome DevTools → Network → 找请求 → 查看 “Size” 列的 “content” vs “transferred”:若 transferred 明显小于 content,说明压缩起效
- 终端命令:
curl -H "Accept-Encoding: gzip" -I https://yoursite.com/api/users | grep encoding确认头存在;再用curl -H "Accept-Encoding: gzip" -s https://yoursite.com/app.js | gunzip -t测试能否无错解压
最易被忽略的一点:Fiber 的 c.Set() 或 c.Append() 若在压缩中间件之后手动改写了 Content-Encoding 或 Vary,会覆盖中间件行为,且无任何报错提示。


















