Gin（Golang）静态文件缓存问题咨询：为何刷新返回200而非304？

嘿，我之前也踩过这个坑！Gin 默认的 router.Static() 方法确实没帮我们处理 HTTP 缓存相关的响应头，导致每次请求静态文件都返回 200，没法触发浏览器的缓存验证（返回304）。其实解决起来不难，核心是借助 Go 标准库的 http.FileServer 自带的缓存验证逻辑，再配合自定义缓存策略就行，下面给你几个可行的方案：

方案一：自定义缓存中间件 + 手动处理静态文件请求 #

http.FileServer 本身就支持生成 ETag 和 Last-Modified 响应头，也能识别客户端发送的 If-None-Match/If-Modified-Since 请求头，自动返回 304。我们只需要给静态文件请求加上合适的 Cache-Control 头，告诉浏览器缓存策略，同时让 http.FileServer 处理文件请求即可：

package main

import (
	"net/http"
	"path/filepath"

	"github.com/gin-gonic/gin"
)

// StaticCacheMiddleware 自定义静态文件缓存中间件，根据文件类型设置缓存策略
func StaticCacheMiddleware() gin.HandlerFunc {
	return func(c *gin.Context) {
		filePath := c.Param("filepath")
		ext := filepath.Ext(filePath)

		// 针对不同文件类型设置不同的缓存有效期
		switch ext {
		case ".js", ".css", ".svg", ".png", ".jpg", ".webp":
			// 静态资源缓存7天
			c.Header("Cache-Control", "public, max-age=604800")
		case ".html", ".htm":
			// HTML文件缓存1小时，方便更新后快速生效
			c.Header("Cache-Control", "public, max-age=3600")
		default:
			// 其他文件默认缓存1天
			c.Header("Cache-Control", "public, max-age=86400")
		}

		// 继续执行后续处理
		c.Next()
	}
}

func main() {
	router := gin.Default()

	// 处理/assets下的所有静态文件请求，先经过缓存中间件，再交给http.FileServer处理
	router.GET("/assets/*filepath", StaticCacheMiddleware(), func(c *gin.Context) {
		http.FileServer(http.Dir("./assets")).ServeHTTP(c.Writer, c.Request)
	})

	router.Run(":8080")
}

方案二：封装自定义FileSystem（进阶玩法） #

如果你想更灵活地控制静态文件的缓存逻辑，可以封装一个自定义的 http.FileSystem 实现，在打开文件时自动添加缓存头：

package main

import (
	"net/http"

	"github.com/gin-gonic/gin"
)

// CachedFileSystem 带缓存头的文件系统包装器
type CachedFileSystem struct {
	http.FileSystem
}

// Open 重写Open方法，添加缓存头
func (fs CachedFileSystem) Open(path string) (http.File, error) {
	file, err := fs.FileSystem.Open(path)
	if err != nil {
		return nil, err
	}

	// 这里可以根据path设置不同的缓存策略，和方案一的逻辑类似
	return file, nil
}

func main() {
	router := gin.Default()

	// 使用自定义的CachedFileSystem，同时添加全局缓存中间件
	router.Use(func(c *gin.Context) {
		c.Header("Cache-Control", "public, max-age=86400")
	})

	router.StaticFS("/assets", CachedFileSystem{http.Dir("./assets")})

	router.Run(":8080")
}

注意事项 #

• 测试时别用强制刷新：按 Ctrl+F5 会强制浏览器跳过缓存，直接发送新请求，这时服务器会返回200。用普通刷新（F5）或者直接在地址栏回车，浏览器才会带上缓存验证头，触发304响应。
• ETag的自动处理：http.Dir 生成的ETag基于文件的修改时间和大小，只要文件内容不变，ETag就不会变，客户端再次请求时会带上If-None-Match，服务器对比后返回304。

内容的提问来源于stack exchange，提问作者sematerix