如何在Gin中实现除指定路由外所有路径都提供静态文件服务

核心原因 #

Gin的路由基于前缀匹配规则，根路径下的通配符路由/*filepath会抢占所有路径的匹配权，与后续定义的/api前缀路由产生冲突，触发panic。

推荐方案：使用NoRoute处理静态资源 #

Gin的NoRoute方法会在所有已注册路由都匹配失败时执行，刚好满足「只有非/api路径走静态文件服务」的需求，完全避免路由冲突。
示例代码如下：

package main

import (
	"net/http"
	"github.com/gin-gonic/gin"
)

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

	// 先定义所有/api前缀的业务路由
	r.GET("/api/v1/foo", func(c *gin.Context) {
		c.JSON(200, gin.H{"foo": true})
	})
	r.GET("/api/v1/bar", func(c *gin.Context) {
		c.JSON(200, gin.H{"bar": true})
	})

	// 未匹配到业务路由的请求全部走静态文件服务
	r.NoRoute(gin.WrapH(http.FileServer(gin.Dir("static", false))))

	r.Run(":9955")
}

该方案无需手动处理路径判断，完全复用Gin原生路由匹配逻辑，实现简洁稳定，是最优选择。

可选方案：通配符路由加前缀判断 #

如果需要直接使用通配符路由，可以在根路径通配符路由的处理逻辑中增加前缀判断，匹配到/api开头的路径时跳过静态处理，走后续业务路由：

package main

import (
	"net/http"
	"strings"
	"github.com/gin-gonic/gin"
)

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

	// 通配符路由必须定义在所有/api路由之前
	r.GET("/*filepath", func(c *gin.Context) {
		if strings.HasPrefix(c.Request.URL.Path, "/api/") {
			c.Next()
			return
		}
		http.FileServer(gin.Dir("static", false)).ServeHTTP(c.Writer, c.Request)
	})

	// 定义/api前缀的业务路由
	r.GET("/api/v1/foo", func(c *gin.Context) {
		c.JSON(200, gin.H{"foo": true})
	})

	r.Run(":9955")
}

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