Mux是Go中功能完备的第三方路由器,支持路径变量、正则约束、子路由和中间件;需用mux.Vars提取变量,Handler推荐结构体实现,中间件可链式应用,子路由利于模块化与权限隔离。

在 Go 中管理 Web 路由,Mux(github.com/gorilla/mux) 是最常用且功能完备的第三方路由器。它比标准库 net/http 的默认多路复用器更灵活,支持路径变量、正则约束、子路由、中间件等特性。搭配自定义 http.Handler,你可以精细控制请求生命周期,实现权限校验、日志记录、参数解析等逻辑。
安装和基础路由设置
先通过 go mod 安装 Mux:
go get -u github.com/gorilla/mux
然后初始化一个带命名路由的 Mux 实例:
r := mux.NewRouter()
r.HandleFunc("/users/{id:[0-9]+}", getUserHandler).Methods("GET")
r.HandleFunc("/posts", postHandler).Methods("POST")
r.HandleFunc("/health", healthHandler).Methods("GET")
注意:{id:[0-9]+} 是带正则约束的路径变量,Mux 会自动提取并注入到 request.URL.Query().Get("id") 不可用,需用 mux.Vars(r *http.Request)["id"] 获取。
立即学习“go语言免费学习笔记(深入)”;
编写符合 Handler 接口的自定义处理器
Go 的 http.Handler 只要求实现 func(http.ResponseWriter, *http.Request) 方法。你可以写结构体方法或闭包,便于复用和注入依赖:
- 结构体方式(推荐):封装数据库、配置、日志等依赖
- 闭包方式:适合轻量逻辑,如简单鉴权或日志包装
示例(结构体 Handler):
type UserHandler struct {
db *sql.DB
logger *log.Logger
}
func (h *UserHandler) ServeHTTP(w http.ResponseWriter, r *http.Request) {
id := mux.Vars(r)["id"]
user, err := h.db.QueryRow("SELECT name FROM users WHERE id = ?", id).Scan(&name)
if err != nil {
http.Error(w, "User not found", http.StatusNotFound)
return
}
json.NewEncoder(w).Encode(map[string]string{"name": name})
}
用中间件统一处理跨切面逻辑
Mux 支持链式中间件,每个中间件接收 http.Handler 并返回新的 http.Handler。常见用途包括:
示例中间件(日志):
func loggingMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
start := time.Now()
next.ServeHTTP(w, r)
log.Printf("%s %s %v", r.Method, r.URL.Path, time.Since(start))
})
}
// 应用到整个路由器
r.Use(loggingMiddleware)
子路由与模块化组织
大型项目建议按业务拆分子路由,避免单个文件臃肿。例如为 API 分组:
api := r.PathPrefix("/api/v1").Subrouter()
api.HandleFunc("/users", userHandler).Methods("GET")
api.HandleFunc("/users", createUserHandler).Methods("POST")
admin := r.PathPrefix("/admin").Subrouter()
admin.Use(authMiddleware) // 仅 admin 路由需要登录
admin.HandleFunc("/dashboard", dashboardHandler).Methods("GET")
子路由可独立挂载中间件、前缀、甚至嵌套其他子路由,利于权限隔离和版本管理。
基本上就这些。Mux + 自定义 Handler 的组合不复杂但容易忽略细节:比如路径变量提取方式、中间件执行顺序、错误响应格式统一。把 Handler 写成结构体、中间件职责单一、子路由按语义分组,就能支撑中等规模 Web 服务的路由管理需求。











