net/http 默认 ServeMux 不适合生产路由管理，因其仅支持前缀匹配，不支持路径参数、方法区分、正则约束及中间件机制，导致路由扩展性差、维护困难且易出错。
为什么 net/http 默认 ServeMux 不适合生产路由管理
Go 标准库的 http.ServeMux 只支持前缀匹配（PathPrefix），不支持动态路径参数（如 /user/123）、正则约束、HTTP 方法区分（GET vs POST 同路径不同处理），也无中间件机制。一旦路由变多，switch r.URL.Path 手动分发极易出错且不可维护。
- 无法捕获
/user/{id}中的id值 - 注册
POST /api/login和GET /api/login会相互覆盖 - 日志、鉴权等逻辑必须在每个 handler 内重复写或靠包装函数，耦合度高
用 gorilla/mux 实现带参数与方法约束的路由分发
gorilla/mux 是最轻量又完备的第三方路由库，它把 URL 路径当作模式来匹配，支持变量提取、方法限定、子路由嵌套，且完全兼容标准 http.Handler 接口。
安装：
go get -u github.com/gorilla/mux
基础用法示例：
立即学习“go语言免费学习笔记（深入）”；
package main
import (
"fmt"
"net/http"
"github.com/gorilla/mux"
)
func main() {
r := mux.NewRouter()
// 支持路径参数：/users/{id}
r.HandleFunc("/users/{id:[0-9]+}", func(w http.ResponseWriter, r *http.Request) {
vars := mux.Vars(r)
id := vars["id"]
fmt.Fprintf(w, "User ID: %s", id)
}).Methods("GET")
// 仅接受 POST，且路径含可选格式后缀
r.HandleFunc("/upload{ext:(\\.json|\\.csv)?}", func(w http.ResponseWriter, r *http.Request) {
ext := mux.Vars(r)["ext"]
fmt.Fprintf(w, "Upload%s received", ext)
}).Methods("POST")
http.ListenAndServe(":8080", r)
}
-
{id:[0-9]+}表示只匹配数字型 ID，正则写在冒号后 -
.Methods("GET")链式调用限定 HTTP 方法，多个方法用.Methods("GET", "HEAD") -
mux.Vars(r)返回map[string]string，是提取参数的唯一安全方式
如何给路由加中间件（如日志、CORS）
gorilla/mux 的中间件本质是包装 http.Handler 的函数，返回新 Handler。它支持全局中间件（对所有路由生效）和局部中间件（只对某子路由生效）。
例如添加请求日志中间件：
func loggingMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
fmt.Printf("Started %s %s\n", r.Method, r.URL.Path)
next.ServeHTTP(w, r)
fmt.Printf("Completed %s %s\n", r.Method, r.URL.Path)
})
}
func main() {
r := mux.NewRouter()
r.Use(loggingMiddleware) // 全局启用
r.HandleFunc("/health", func(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(http.StatusOK)
w.Write([]byte("ok"))
})
http.ListenAndServe(":8080", r)
}
-
r.Use()添加的中间件按注册顺序执行，类似洋葱模型 - 若只想对某组路由加中间件，可用
r.PathPrefix("/api").Subrouter().Use(authMiddleware) - 注意：中间件中调用
next.ServeHTTP是必须的，漏掉会导致后续 handler 完全不执行
自定义 404 和 405 处理容易被忽略的细节
gorilla/mux 默认 404 响应是空 body + 404 状态码，用户体验差；而 405（Method Not Allowed）默认直接 panic，需显式拦截。
- 设置 404 handler：用
r.NotFoundHandler = http.HandlerFunc(...) - 设置 405 handler：用
r.MethodNotAllowedHandler = http.HandlerFunc(...) - 二者必须在
http.ListenAndServe之前赋值，否则无效
完整示例：
r := mux.NewRouter()
r.HandleFunc("/", homeHandler).Methods("GET")
r.HandleFunc("/api/data", dataHandler).Methods("GET", "POST")
r.NotFoundHandler = http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
http.Error(w, "Route not found", http.StatusNotFound)
})
r.MethodNotAllowedHandler = http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
http.Error(w, "Method not allowed", http.StatusMethodNotAllowed)
})
http.ListenAndServe(":8080", r)
真正上线时，404 页面最好返回 HTML 或 JSON，且带上 trace ID 方便排查；405 则建议统一返回 Allow header，比如 w.Header().Set("Allow", "GET, POST")。
