httprouter 不支持基于 URL 查询参数（如 /search?key=:tags）的路由匹配；必须使用固定路径注册路由，再通过 r.URL.Query() 手动解析 query string 中的参数。
httprouter 不支持基于 url 查询参数（如 `/search?key=:tags`）的路由匹配；必须使用固定路径注册路由，再通过 `r.url.query()` 手动解析 query string 中的参数。
httprouter 是一个轻量、高性能的 Go HTTP 路由库，但它不支持将查询参数（query string）作为路由变量进行匹配——也就是说，像 /search?key=:tags 这样的写法是无效的，它不会被识别为合法路由模式，导致请求始终 404。
正确的做法是：将路由定义为静态路径（如 /search），然后在处理函数中主动解析 r.URL.Query() 获取参数值。
以下是修正后的完整代码示例：
package main
import (
"net/http"
"log"
"html/template"
"fmt"
"github.com/julienschmidt/httprouter"
)
func main() {
router := httprouter.New()
router.GET("/", Search)
router.GET("/search", GrabQuestions) // ✅ 改为纯路径匹配
log.Fatal(http.ListenAndServe(":8080", router))
}
func Search(w http.ResponseWriter, r *http.Request, _ httprouter.Params) {
t, err := template.ParseFiles("E:/work/src/github.com/krashcan/sos/template/index.html")
if err != nil {
log.Println("模板解析失败:", err)
http.Error(w, "模板加载失败", http.StatusInternalServerError)
return
}
t.Execute(w, nil)
}
func GrabQuestions(w http.ResponseWriter, r *http.Request, _ httprouter.Params) {
// ✅ 正确获取 query 参数：r.URL.Query().Get("tags")
tags := r.URL.Query().Get("tags")
if tags == "" {
fmt.Fprintf(w, "未提供 tags 参数")
return
}
fmt.Fprintf(w, "接收到的标签：%s", tags)
}
? 关键说明与注意事项：
- HTML 表单
<form method="get"></form>提交时，浏览器会自动将name="tags"的输入框值拼成查询字符串，例如：/search?tags=go,web,api； -
httprouter.Params仅用于匹配路径段中的命名参数（如/user/:id），对?key=value类型的查询参数完全不可见； - 务必检查
r.URL.Query().Get("tags")是否为空，避免空值误处理； - 若需支持多个同名参数（如
?tags=go&tags=web），可使用r.URL.Query()["tags"]获取[]string切片； - 路由注册必须严格对应实际请求路径（不含 query string），否则一律 404。
✅ 总结：httprouter 的设计哲学是“路径即路由”，查询参数属于请求负载的一部分，应由业务逻辑层统一解析——这是性能与语义清晰性的权衡，而非缺陷。掌握这一原则，即可避免绝大多数 404 路由陷阱。
