Go标准库http.ServeMux仅支持前缀匹配，不支持路径参数、正则、通配符或HTTP方法区分；gorilla/mux提供语义化路由，支持变量捕获、方法限制和子路由；自定义Handler适用于极简场景，需注意路径规范化与错误处理。
Go标准库http.ServeMux的匹配逻辑很有限
http.ServeMux只支持前缀匹配，不支持路径参数、正则、通配符或方法区分。比如注册 /users/ 会同时匹配 /users、/users/123、/users/profile/edit —— 它只是简单地检查请求路径是否以注册路径开头。
这意味着你无法用它实现类似 /users/{id} 或 GET /api/v1/users 与 POST /api/v1/users 分开处理的需求。
常见错误现象：
- 注册 /user 后，访问 /userabc 也被路由到该 handler
- 想按 HTTP 方法分发，但 ServeMux 完全忽略 Method
- 需要解析路径段（如提取 id），但 Request.URL.Path 是原始字符串，无结构化解析
用gorilla/mux做语义化路由管理
这是最常用、稳定且文档清晰的第三方路由库。它把路径视为可解析的模式，支持变量捕获、约束条件、方法限制和子路由。
实操建议：
- 安装：go get -u github.com/gorilla/mux
- 基础注册：
router := mux.NewRouter()
router.HandleFunc("/users/{id:[0-9]+}", getUser).Methods("GET")- 提取参数：
vars := mux.Vars(r) → 得到 map[string]string{"id": "123"}- 子路由可用于版本隔离：
v1 := router.PathPrefix("/api/v1").Subrouter()
v1.HandleFunc("/users", listUsers).Methods("GET")- 注意：变量名必须是合法 Go 标识符（不能含
- 或 /），约束正则不能包含捕获组（即不能用 (\d+)，得写 [0-9]+）
自定义http.Handler实现轻量级匹配
如果项目极简、不想引入依赖，可直接实现 http.Handler 接口，用 strings.Split 或 path.Match 手动解析。
适用场景：
- 固定几条路由（如 /health、/metrics）
- 路径结构高度可控（如全部为 /v1/{resource}/{id}）
- 需要完全控制中间件注入顺序或 panic 恢复逻辑
关键点：
- 不要用 strings.HasPrefix 模拟前缀匹配（易被绕过），改用 path.Clean 规范化路径再比对
- 匹配失败时务必调用 http.NotFound(w, r)，否则可能返回空响应或 200
- 若需提取路径段，用 strings.TrimPrefix + strings.Split 比正则更轻量（无编译开销）
- 示例片段：
func (r *SimpleRouter) ServeHTTP(w http.ResponseWriter, req *http.Request) {
path := path.Clean(req.URL.Path)
switch path {
case "/health":
w.WriteHeader(http.StatusOK)
w.Write([]byte("ok"))
case "/users":
if req.Method == "GET" {
listUsers(w, req)
} else {
http.Error(w, "Method not allowed", http.StatusMethodNotAllowed)
}
default:
http.NotFound(w, req)
}
}
路由性能与调试注意事项
gorilla/mux 在路由数量超 50 条后，匹配耗时会明显上升（线性扫描）。生产环境若路由数达数百，应考虑：
- 使用 chi（基于 trie，支持中间件链式调用）
- 将高频静态路径（如 /favicon.ico、/robots.txt）前置到独立 http.ServeMux 中，绕过复杂路由器
- 开启 router.UseEncodedPath() 防止 URL 编码路径（如 %2F）被误判
调试技巧：
- 启动时打印所有注册路由：fmt.Printf("Registered: %+v\n", router.Routes())（注意返回的是未导出字段，仅用于 debug）
- 用 curl -v 看实际响应头，确认状态码和 Content-Type 是否符合预期
- 路由未命中却没报错？检查是否漏了 .Methods("GET")，默认允许所有方法，但 handler 内部可能未处理
路由真正难的不是注册语法，而是路径设计一致性、错误路径的 fallback 行为、以及和中间件（如 auth、logging）的生命周期耦合。别在第一个 handler 里就 parse body，先让路由层决定“这个请求归谁管”。
