Go标准库http.ServeMux仅支持前缀匹配,不支持路径参数、方法限制、中间件;gorilla/mux提供RESTful路由、正则约束和子路由;自定义路由器可实现方法分发但无动态路径提取。
http.ServeMux能用,但要注意它不支持路径参数和通配符Go原生net/http包里的http.ServeMux是最轻量的路由选择,适合静态路径映射。但它只做前缀匹配,比如注册/api/users,实际会同时匹配/api/users/123和/api/users/delete,且无法提取/users/{id}这类路径段。
http.HandleFunc("/path", handler),底层调用DefaultServeMux.HandleFunc
GET/POST,所有方法都走同一个HandlerFunc,需手动检查r.Method
/admin和/admin/被视为不同路由gorilla/mux才真正支持RESTful路由如果需要路径参数、方法限制、子路由或中间件,gorilla/mux仍是目前最稳定的选择。它兼容http.Handler接口,可直接替换DefaultServeMux。
router.HandleFunc("/users/{id}", handler).Methods("GET")明确限定方法vars := mux.Vars(r)获取{id}值,返回map[string]string
router.HandleFunc("/users/{id:[0-9]+}", handler)
adminRouter := router.PathPrefix("/admin").Subrouter()
chi(更轻、API更简洁)http.Handler接口不需要完整框架时,几行代码就能写出支持方法分发和路径分割的简易路由器。核心是解析r.URL.Path并比对,再根据r.Method调用对应函数。
type Router struct {
routes map[string]map[string]http.HandlerFunc // method -> path -> handler
}
func (r *Router) ServeHTTP(w http.ResponseWriter, req *http.Request) {
if handler, ok := r.routes[req.Method][req.URL.Path]; ok {
handler(w, req)
return
}
http.Error(w, "Not Found", http.StatusNotFound)
}
func (r *Router) GET(path string, f http.HandlerFunc) {
if r.routes["GET"] == nil {
r.routes["GET"] = make(map[string]http.HandlerFunc)
}
r.routes["GET"][path] = f
}
/user/:id,但足够应付CLI工具API或内部服务http.ServeMux会自动重定向末尾带斜杠的路径,而自定义路由器不会——需自行处理/admin→/admin/跳转实测中,从http.ServeMux换到gorilla/mux或chi,QPS变化几乎不可测(相同硬件下差异
gorilla/mux用前缀树+正则回溯,chi用手工写的trie,两者在万级路由下才有明显区别pprof确认热点,再决定是否换库http.ServeMux,避免注册过多重复前缀(如/v1/a、/v1/b、/v1/c),它内部是线性查找路径参数解析和中间件链式调用带来的可维护性提升,远比微秒级匹配开销重要。选库时优先看文档清晰度和错误提示是否友好——比如405 Method Not Allowed能不能准确定位到哪条路由没配POST。