Go标准库net/http不支持动态路由参数,需用gorilla/mux等第三方库;通过{param}定义路径参数,mux.Vars(r)获取,支持正则约束与中间件校验。

在 Go 语言中,使用标准库 net/http 本身不直接支持类似 /user/:id 这样的动态路由参数解析,需要借助第三方路由器(如 gorilla/mux、chi)或手动解析 URL 路径。下面以最常用、轻量且功能完整的 gorilla/mux 为例,说明如何实现路由参数的定义与动态获取。
安装并初始化 mux 路由器
先通过 go mod 安装依赖:
go get -u github.com/gorilla/mux
然后在代码中创建路由器实例,并注册带参数的路由:
立即学习“go语言免费学习笔记(深入)”;
- 路径中用
{name}或{name:pattern}定义变量段,例如/api/users/{id} -
id就是参数名,后续可在 handler 中按名提取 - 支持正则约束,如
{id:[0-9]+}只匹配数字
在 Handler 中提取 URL 路径参数
使用 mux.Vars(r) 获取一个 map[string]string,键为路由中定义的参数名:
func getUser(w http.ResponseWriter, r *http.Request) {
vars := mux.Vars(r)
id := vars["id"] // 如请求 /api/users/123,则 id == "123"
fmt.Fprintf(w, "User ID: %s", id)
}
- 注意:
vars是从路径解析出的,不是查询参数(?name=xxx) - 若参数未定义或路由未匹配,
vars可能为空 map,建议加判空 - 类型转换需自行处理,比如
strconv.Atoi(id)转整数
同时支持路径参数和查询参数
真实场景常需混合使用。路径参数用于资源标识,查询参数用于过滤或分页:
// 路由:/api/posts/{category}
// 请求:GET /api/posts/golang?limit=10&offset=0
- 路径参数仍用
mux.Vars(r)["category"]获取 - 查询参数用
r.URL.Query().Get("limit")或r.FormValue("limit") -
FormValue自动合并 URL 查询和表单数据,更通用
可选:自定义中间件统一校验参数
对关键参数(如 id 必须为正整数),可封装校验逻辑避免重复代码:
func requireID(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
idStr := mux.Vars(r)["id"]
if idStr == "" {
http.Error(w, "Missing ID", http.StatusBadRequest)
return
}
if _, err := strconv.ParseUint(idStr, 10, 64); err != nil {
http.Error(w, "Invalid ID format", http.StatusBadRequest)
return
}
next.ServeHTTP(w, r)
})
}
- 将校验逻辑抽成中间件,配合
router.Use()或链式调用 - 校验通过后再交由业务 handler 处理,职责清晰











