
Go 中使用 gorilla/mux 时返回 404,通常是因为未将配置好的路由处理器传给 http.ListenAndServe,而是错误地传入了 nil。
go 中使用 gorilla/mux 时返回 404,通常是因为未将配置好的路由处理器传给 http.listenandserve,而是错误地传入了 nil。
在 Go 的 HTTP 服务中,http.ListenAndServe(addr, handler) 的第二个参数 handler 决定了如何处理请求:若传入 nil,Go 会默认使用 http.DefaultServeMux —— 这是一个全局的、独立于你创建的 mux.Router 的路由实例。因此,即使你调用了 router.HandleFunc("/hi", SayHi),该路由规则也仅注册在 router 实例上,而 DefaultServeMux 完全不知情,所有请求都会因无匹配路由而返回 404。
✅ 正确做法是:将构建好的 router 实例作为 handler 传入:
func main() {
router := mux.NewRouter()
router.HandleFunc("/hi", SayHi).Methods("GET") // 推荐显式指定方法
log.Println("Server starting on :8080")
log.Fatal(http.ListenAndServe(":8080", router)) // ← 关键修复:传 router,非 nil
}
func SayHi(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Content-Type", "text/plain; charset=utf-8")
fmt.Fprintln(w, "Hi")
}⚠️ 注意事项:
-
router.HandleFunc(...)默认不自动限制 HTTP 方法,若需严格匹配(如仅响应 GET),务必链式调用.Methods("GET"); - 可通过
router.StrictSlash(true)启用尾部斜杠重定向(如/hi→/hi/); - 开发阶段建议添加日志中间件或使用
router.Use(mux.MiddlewareFunc(...))便于调试; - 若仍 404,请检查路径是否完全匹配(区分大小写、前导斜杠)、浏览器是否缓存了旧响应(可尝试
curl -v http://localhost:8080/hi验证)。
修复后访问 http://localhost:8080/hi 即可成功返回 "Hi" —— 这是正确连接自定义路由器与 HTTP 服务器的关键一步。

















