Fiber 的 app.Static() 默认配置在生产环境性能差，因重复 os.Stat、filepath.Clean 和缺失缓存头/gzip/MIME 推导；需自定义 safeFS、手动设缓存与压缩、显式处理 SPA fallback。
直接用 app.Static() 就能跑，但默认配置在生产环境会拖慢 QPS、漏缓存头、不压缩、甚至被路径遍历攻击——这不是 Fiber 的问题，是你没关掉调试、没设缓存策略、也没绕过冗余校验。
为什么 app.Static("/static", "./public") 在压测时延迟飙升
Fiber 的 app.Static() 底层仍走 http.FileServer，而默认行为会触发三类开销：
- 每次请求都调
os.Stat检查文件是否存在，小文件场景下磁盘 I/O 成瓶颈 - 自动启用
filepath.Clean()做路径标准化，对每个请求做字符串扫描和拼接 - 不设
Cache-Control、不启 gzip、不预设 MIME，浏览器反复拉全量 JS/CSS，网卡和 CPU 都在干无用功
实测在 16 核机器上，未调优的 app.Static() 在 2 万并发时 TTFB 稳定在 8–12ms；加缓存头 + gzip + 预 stat 后压到 0.9–1.3ms。
绕过 filepath.Clean 但守住安全边界
别用 http.Dir 包裹目录，它每次请求都 clean 并比对前缀。改用自定义 http.FileSystem，只做一次校验：
type safeFS struct {
root string
}
func (fs safeFS) Open(path string) (http.File, error) {
cleanPath := filepath.Clean(path)
if !strings.HasPrefix(cleanPath, "/") || strings.Contains(cleanPath, "..") {
return nil, fs.Err()
}
fullPath := filepath.Join(fs.root, cleanPath)
if !strings.HasPrefix(fullPath, fs.root) {
return nil, fs.Err()
}
return os.Open(fullPath)
}
// 注册时：
app.Static("/static", safeFS{root: "/var/www/static"})
注意：filepath.Join(fs.root, cleanPath) 后必须再比对 fullPath 是否仍在 fs.root 下，否则 /var/www/static/../../etc/passwd 可绕过。
强制启用 gzip、缓存头和 MIME 推导
Fiber 不会自动开这些，必须手动补：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- gzip：用
fiber.Compression()中间件包住静态路由，别用 Nginx 双重压缩 - 缓存头：对
.js、.css、.woff2设Cache-Control: public, max-age=31536000；HTML 设no-cache或带哈希后缀（如index.a1b2c3.html） - MIME：优先用
mime.TypeByExtension(filepath.Ext(path))，fallback 到http.DetectContentType(buf[:n])（读前 512 字节）
示例中间件片段：
app.Use("/static", func(c *fiber.Ctx) error {
path := c.Path()
ext := filepath.Ext(path)
if mime := mime.TypeByExtension(ext); mime != "" {
c.Set("Content-Type", mime)
}
switch ext {
case ".js", ".css", ".woff2":
c.Set("Cache-Control", "public, max-age=31536000")
default:
c.Set("Cache-Control", "no-cache")
}
return c.Next()
})
SPA fallback 路由别让 app.Static() 自动处理
app.Static("/", "./public", fiber.Static{Fallback: "index.html"}) 看似方便，但它会在每次 404 时重新进一遍 os.Stat("./public/index.html")，且无法区分真实 404 和路由 fallback。更稳做法是显式拦截：
app.Get("*", func(c *fiber.Ctx) error {
// 先检查文件是否存在
fullPath := filepath.Join("./public", c.Path())
if _, err := os.Stat(fullPath); err == nil {
return c.SendFile(fullPath)
}
// 不存在才 fallback
return c.SendFile("./public/index.html")
})
这个写法能避免重复 stat，也方便你在 fallback 前加鉴权或埋点——而 Fallback 参数是黑盒逻辑，没法插手。
真正卡性能的从来不是框架抽象，而是你让每个请求都重复做 os.Stat、重复 clean 路径、重复推 MIME、重复不设缓存。这些细节不手动控，app.Static() 就只是个能跑的玩具。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
