本文介绍如何在 gorilla mux 路由器中正确提取 http 请求的查询参数（query string），并将其转换为 go 的 `map[string]string` 结构，适用于 restful api 开发场景。
在 Gorilla Mux 中，路径参数（如 /api/{action}）通过 mux.Vars(r) 获取，而查询参数（即 URL 中 ? 后的键值对，如 ?id=hello&password=great）不属于路由变量，而是由标准库 net/http 的 *http.Request 对象原生支持解析。
要获取 GET /api/v3?id=hello&password=great&product=ipad&confirm=true 中的所有查询参数并构建成 map[string]string，推荐以下两种方式：
✅ 方式一：逐个读取（简洁安全，推荐用于已知字段）
func myHandler(w http.ResponseWriter, r *http.Request) {
// 提取路径变量（如果路由中定义了，例如 /api/{version}）
vars := mux.Vars(r)
if version, ok := vars["version"]; ok {
log.Printf("Version: %s", version) // 如匹配 /api/{version} → /api/v3
}
// 逐个获取查询参数（自动解码 URL 编码）
id := r.FormValue("id")
password := r.FormValue("password")
product := r.FormValue("product")
confirm := r.FormValue("confirm")
log.Printf("Params: %+v", map[string]string{
"id": id,
"password": password,
"product": product,
"confirm": confirm,
})
}⚠️ 注意：r.FormValue(key) 内部会自动调用 r.ParseForm()（若尚未解析），因此无需手动调用；它对重复 key 只返回第一个值，且对空值/缺失 key 返回空字符串。
✅ 方式二：完整解析为 map（适用于动态或未知参数）
func myHandler(w http.ResponseWriter, r *http.Request) {
// 显式解析表单（含 query string），确保 Form 已加载
if err := r.ParseForm(); err != nil {
http.Error(w, "Invalid query string", http.StatusBadRequest)
return
}
// 构建 map[string]string —— 注意：r.Form 是 map[string][]string
params := make(map[string]string)
for key, values := range r.Form {
if len(values) > 0 {
params[key] = values[0] // 取第一个值（与 FormValue 行为一致）
}
}
log.Printf("All query params: %+v", params)
// 输出：map["confirm":"true" "id":"hello" "password":"great" "product":"ipad"]
}? 路由注册示例（配合上述 handler）
r := mux.NewRouter()
// 匹配 /api/v3，不捕获路径变量；若需版本号，建议用 /api/{version}
r.Methods("GET").Path("/api/v3").HandlerFunc(myHandler)
// 或更灵活地支持任意子路径 + 查询参数（推荐 API 版本化设计）
// r.Methods("GET").Path("/api/{version}").HandlerFunc(myHandler)
http.ListenAndServe(":3000", r)? 补充说明
- 查询参数不区分大小写？否 —— r.FormValue("ID") ≠ "hello"，key 区分大小写；
- 中文或特殊字符（如 ?name=张三&tag=go%2Bweb）会被自动 URL 解码，无需额外处理；
- 若需支持 POST application/x-www-form-urlencoded 数据，r.ParseForm() 同样适用；
- 生产环境建议增加参数校验（非空、类型转换、白名单过滤等），避免直接信任 FormValue。
掌握这两种方式，你就能在 Gorilla Mux 中高效、安全地处理各类查询参数，并灵活构建所需的数据结构。
