fastapi中没有app.static()方法，正确方式是使用app.mount()挂载staticfiles；例如app.mount("/static", staticfiles(directory="static"), name="static")。
怎么用 app.Static() 挂载静态资源目录
直接调用 app.Static() 是最常用、也最不容易出错的方式。它本质是注册一个只响应特定前缀路径的文件服务中间件，内部自动处理 MIME 类型、缓存头、目录遍历防护等。
- 第一个参数是请求路径前缀，比如
"/static"，用户访问/static/logo.png时才会触发 - 第二个参数是本地文件系统路径，必须是**绝对路径或相对于当前工作目录的相对路径**；推荐用
filepath.Join(".", "public")构造，避免硬编码 - 不支持通配符或嵌套前缀，比如
app.Static("/assets/css", "./css")是非法的——app.Static()只接受单层前缀映射 - 若目录下有
index.html，默认不会自动返回；需要额外配置Index: "index.html"（v2）或使用fiber.StaticConfig（v3）
为什么 app.Use() + static.New() 更灵活但容易踩坑
static.New() 返回的是一个中间件函数，配合 app.Use() 可以实现更细粒度控制，比如挂载到子路径、组合其他中间件，但对路径匹配逻辑要求更严格。
- 前缀必须完整且精确：写成
app.Use("/static", static.New("./public"))才有效；写成app.Use(static.New("./public"))会把所有请求都交给它处理，导致 API 路由失效 -
static.New()不自动加/重定向，访问/static（无尾斜杠）不会自动跳转到/static/，而app.Static()会 - v2 中
static.New()默认不启用目录浏览，需显式设DirectoryBrowse: true；v3 中该选项已移除，需自行实现 - 如果同时用了 CDN 或反向代理，注意原始请求路径可能被改写，
static.New()匹配的是c.Path()，不是原始 URL
如何让 / 根路径自动返回 index.html
Fiber 默认不把根路径当作静态文件入口，app.Static("/", "./public") 不能替代首页路由。真要实现 SPA 的 fallback 行为，得手动处理。
- 最稳妥方式：先注册静态服务，再在最后加一条兜底路由：
app.Get("*", func(c *fiber.Ctx) error { return c.SendFile("./public/index.html") }) - 不要把
app.Static("/", "./public")放在最后——它会拦截所有未匹配路由，包括 API 接口，造成 404 - 若只想对某些扩展名 fallback（如
.html,.js），可用正则路由：app.Get("/:path(*)", func(c *fiber.Ctx) error { if strings.HasSuffix(c.Params("path"), ".html") { return c.SendFile("./public/" + c.Params("path")) } return c.Next() }) - 注意
SendFile()会读取整个文件进内存，大文件建议用SendStream()配合os.Open()
常见错误：路径没生效、404、跨域或 MIME 错误
多数问题出在路径解析和中间件顺序上，而不是框架本身。
- 启动时工作目录不是项目根目录？用
os.Executable()或os.Getwd()打印确认，别依赖 IDE 的“运行目录”设置 - 文件权限问题：Linux 下 Go 进程可能无权读取
./public，检查ls -l public和用户 UID - MIME 类型错误（比如 JS 被当成 text/plain）：Fiber v2 默认基于扩展名推断，确保文件后缀正确；v3 可通过
ContentType: "application/javascript"强制指定 - CORS 报错但静态资源能加载？那是前端代码的问题，静态文件服务本身不涉及 CORS；真正要处理的是 API 接口，用
c.Set("Access-Control-Allow-Origin", "*")或cors.New()中间件
./public 可能根本不存在于镜像里，或者挂载路径写错。动手前先 fmt.Println(filepath.Abs("./public")) 看一眼实际路径，比反复重启快得多。
