应通过预收集静态路由前缀并在日志中间件中匹配请求路径来过滤静态文件日志；需手动维护staticPrefixes列表，c.Next()必须在跳过判断前执行以确保响应正常。
默认的 Logger 中间件会记录所有请求，包括 /favicon.ico、/assets/css/app.css 这类静态文件请求——它们高频、无业务意义，却大量污染日志，还可能干扰错误排查。直接禁用全局日志又会丢掉关键接口日志，所以得在自定义日志中间件里做「条件过滤」。
如何判断请求是否为静态文件
Gin 本身不提供「这是不是静态文件请求」的 API，但你可以通过 c.Request.URL.Path 和已注册的静态路由路径做字符串前缀匹配。比如你用了 r.Static("/assets", "./assets")，那所有以 /assets/ 开头的请求就该被跳过。
- 不要依赖
c.HandlerName()或c.FullPath()：它们在静态路由下返回空或不可靠值 - 不要硬编码后缀（如
.css、.png）：容易漏判，且无法覆盖StaticFS等嵌入式场景 - 推荐方式：提前收集所有静态路由前缀，存成
[]string，在中间件里遍历比对c.Request.URL.Path
自定义日志中间件中跳过静态路径
核心是把日志写入逻辑包裹在条件判断里，而不是删掉 c.Next()——否则会中断请求链。
func FilteredLogger(staticPrefixes []string) gin.HandlerFunc {
return func(c *gin.Context) {
path := c.Request.URL.Path
skip := false
for _, prefix := range staticPrefixes {
if strings.HasPrefix(path, prefix) {
skip = true
break
}
}
start := time.Now()
c.Next() // 必须调用，否则请求卡住
if skip {
return // 不记录
}
latency := time.Since(start)
status := c.Writer.Status()
method := c.Request.Method
log.Printf("[%s] %s %d %v", method, path, status, latency)
}
}
- 注意
c.Next()必须在if skip判断之前执行，否则静态请求根本不会被响应 -
staticPrefixes需手动维护，例如：[]string{"/assets/", "/static/", "/favicon.ico"} - 如果用了
r.StaticFile("/favicon.ico", ...)，要显式加"/favicon.ico"，因为它是精确匹配，不是前缀
为什么不能用 router.NoRoute() 拦截静态请求
NoRoute 只捕获未匹配到任何路由的请求，而 r.Static(...) 注册的路径是真实路由，会被正常匹配并处理——它根本不会走到 NoRoute 里。
- 试图在
NoRoute里记录日志，对静态请求完全无效 - 也不建议用
Abort()或修改Writer去“伪造”跳过：这会破坏 Gin 的响应流程，可能导致 Content-Length 错误或连接异常 - 唯一可靠入口，就是日志中间件自身的执行时机
真正麻烦的不是写代码，而是维护 staticPrefixes 列表——每次加新静态路由（比如 r.Static("/uploads", "./uploads")），都得同步更新这个列表，漏掉一个就会继续刷日志。别指望自动发现，Gin 没暴露已注册静态路径的反射接口。
