静态资源请求会被中间件拦截，因为Iris中间件默认对所有路径（包括/static/js/app.js）生效；若未用iris.RouterSkipMiddleware显式跳过，鉴权等中间件会执行并可能返回401或放行致404。
静态资源请求为什么会被中间件拦截
Iris 的中间件默认对所有请求生效，包括 /static/js/app.js、/images/logo.png 这类路径。如果你在全局注册了日志、鉴权或 CORS 中间件，它们会先于静态文件处理器执行——而一旦中间件里调用了 c.Next() 之后没有显式终止流程（比如没写 c.ServeFile() 或 c.File()），请求就可能被放行到后续路由，最终 404；或者更糟：鉴权中间件对静态资源也校验 token，直接返回 401。
用 iris.StaticWeb() 前必须跳过中间件
最稳妥的做法是把静态资源挂载为独立的子路由器，并用 iris.RouterSkipMiddleware 显式禁用中间件链。否则即使路径匹配，中间件仍会执行：
// 正确：静态路由完全绕过中间件
staticRouter := app.Party("/static", iris.RouterSkipMiddleware)
staticRouter.StaticWeb("/", "./public")
<p>// 错误：下面这行会让日志/鉴权等中间件仍作用于 /static/*
app.Use(loggerHandler, authHandler)
app.StaticWeb("/static", "./public")</p>
-
iris.RouterSkipMiddleware是一个特殊中间件标识，不是函数调用，不能加括号 - 路径前缀（如
/static）必须和StaticWeb()第一个参数一致，否则 404 -
./public目录需存在且有读取权限，Iris 不会自动创建
需要中间件干预静态请求时怎么办
极少数场景下你确实要处理静态请求，比如添加 ETag、强制缓存头、或按 User-Agent 重写路径。这时不能用 StaticWeb()，得手动接管：
app.Get("/static/{file:path}", func(c iris.Context) {
filename := c.Params().Get("file")
// 校验 filename 是否合法（防 ../ 路径遍历）
if strings.Contains(filename, "..") || strings.HasPrefix(filename, "/") {
c.StatusCode(iris.StatusForbidden)
return
}
filepath := filepath.Join("./public", filename)
if _, err := os.Stat(filepath); os.IsNotExist(err) {
c.StatusCode(iris.StatusNotFound)
return
}
c.Header("Cache-Control", "public, max-age=31536000")
c.ServeFile(filepath, false) // false 表示不尝试自动猜测 MIME 类型
})
- 必须手动做路径安全校验，
StaticWeb()内部做了，但手写逻辑里容易漏 -
c.ServeFile(filepath, false)比c.File(filepath)更可控：后者会触发 MIME 探测和重定向，可能破坏 CDN 缓存行为 - 不要在该 handler 里调用
c.Next()，否则可能二次响应或 panic
开发与生产环境的 MIME 类型差异
Iris 默认根据文件扩展名设置 Content-Type，但部分类型（如 .webp、.avif）在旧版 Go 或某些系统上识别失败，导致浏览器拒绝加载。解决方案是提前注册：
iris.RegisterContentType("webp", "image/webp")
iris.RegisterContentType("avif", "image/avif")
// 在 app.Listen() 之前调用
- 这个注册是全局的，影响所有
ServeFile、StaticWeb和File调用 - 如果用了自定义
http.ServeMux或反向代理，该设置无效——那是底层 HTTP 服务器的行为 - 注意大小写：
RegisterContentType("WEBP", ...)不生效
真正麻烦的是那些没扩展名的资源（比如构建工具输出的无后缀 JS bundle），此时只能靠手动 c.Header("Content-Type", "...") + c.Write()，Iris 不提供基于内容嗅探的 fallback 机制。
