Go标准库http.ServeMux采用严格前缀匹配，要求已注册路径以/结尾或为根路径，否则可能触发301重定向；gorilla/mux支持精确匹配与正则约束的路径变量；StripPrefix用于清理子路径前缀，自定义Handler重写路径时需注意RequestURI不更新。

Go 标准库 http.ServeMux 的路径匹配是前缀匹配，不是全路径匹配

当你注册 /api，它会匹配 /api、/api/users、/api/v1/xxx?foo=bar，甚至 /apixxx（注意：这是常见误解，实际不会匹配 /apixxx；ServeMux 是严格前缀匹配，且要求路径分隔符对齐）。关键点在于：它会在 URL 路径中查找最长的**已注册前缀**，且该前缀必须以 / 结尾（或本身就是根 /），否则可能触发意外跳转。

常见错误现象：http.HandleFunc("/api", handler) 后访问 /api 正常，但 /api/（带尾部斜杠）可能被重定向到 /api/（如果 handler 没显式处理），因为 ServeMux 对末尾斜杠有特殊逻辑——若注册路径不以 / 结尾，而请求路径以 / 结尾且匹配前缀，则自动 301 重定向到带斜杠版本。

• 注册 /api → 请求 /api/ 触发重定向到 /api/（即加斜杠）
• 注册 /api/ → 请求 /api 不匹配，404；请求 /api/ 或 /api/users 才匹配
• 若需同时支持无斜杠和有斜杠，需显式注册两个路径，或统一用带斜杠形式

第三方路由如 gorilla/mux 支持精确路径 + 变量提取

gorilla/mux 是最常用的增强型路由器，它把路径当作模板来解析，支持 {id}、{id:[0-9]+} 这类占位符，匹配行为是精确的（不是前缀），且按注册顺序+规则优先级决定谁先命中。

使用场景：RESTful API 需要区分 /users（集合）和 /users/{id}（单个资源），或需要从路径中直接提取参数。

router := mux.NewRouter()
router.HandleFunc("/users", listUsers).Methods("GET")
router.HandleFunc("/users/{id:[0-9]+}", getUser).Methods("GET")
router.HandleFunc("/users/{id:[0-9]+}/posts", getUserPosts).Methods("GET")

• 路径必须完全匹配，/users/123 不会匹配 /users
• 正则约束 [0-9]+ 能防止 /users/abc 错误进入 getUser 处理器
• 变量名（如 id）可通过 req.URL.Query().Get("id") 获取？错——要用 mux.Vars(req)["id"]
• 注意：未加正则的 {id} 会匹配任意非 / 字符，包括空字符串，容易引发歧义

net/http 中 http.StripPrefix 和子路由嵌套的实际作用

当把路由挂载到子路径（如 /admin/...）时，处理器收到的 req.URL.Path 仍含完整路径。如果不清理，FileServer 或静态资源处理会失败。

例如挂载 http.FileServer(http.Dir("./static")) 到 /static/，访问 /static/js/app.js 时，FileServer 会尝试打开 ./static/static/js/app.js —— 多了一层 static。

• 必须用 http.StripPrefix("/static/", fileServer) 把前缀切掉，让 FileServer 看到的是 /js/app.js
• StripPrefix 只影响 req.URL.Path，不影响查询参数或请求体
• 在 gorilla/mux 中可用 Subrouter() 实现类似效果，更安全：它自动隔离路径上下文，无需手动 Strip

自定义 http.Handler 实现路径重写时要注意 req.RequestURI 不更新

如果你在中间件里修改了 req.URL.Path（比如把 /v1/users 改成 /users），下游处理器能看到新路径，但 req.RequestURI（原始请求行中的字符串）保持不变。这通常不影响逻辑，但在日志、调试或某些依赖原始 URI 的代理逻辑中会出问题。

• 不要依赖 req.RequestURI 做路由判断，应始终用 req.URL.Path
• 若需记录“重写后”的请求入口，建议在中间件中显式存入 req.Context()，而非覆盖不可变字段
• 重写路径后调用 http.Redirect 时，目标地址应基于新路径构造，而不是原 RequestURI

路径匹配的细节藏在「斜杠是否结尾」「前缀是否对齐」「变量是否带约束」「URL 字段是否同步更新」这些地方，漏掉任何一个，都可能导致 404、重定向循环或参数取不到。