
Go 中使用 gorilla/mux 时返回 404,通常是因为未将配置好的路由处理器传递给 http.ListenAndServe(),而是错误地传入了 nil。
go 中使用 gorilla/mux 时返回 404,通常是因为未将配置好的路由处理器传递给 http.listenandserve(),而是错误地传入了 nil。
在你提供的代码中,问题出在这一行:
log.Fatal(http.ListenAndServe(":8080", nil))
虽然你已通过 mux.NewRouter() 创建并配置了路由(如 router.HandleFunc("/hi", SayHi)),但 http.ListenAndServe() 的第二个参数是 HTTP 处理器(Handler)。传入 nil 会触发 Go 标准库使用默认的 http.DefaultServeMux —— 它完全不感知你创建的 router 变量,因此所有请求均无法匹配,统一返回 404。
✅ 正确做法是:将 router 实例作为处理器显式传入:
package main
import (
"fmt"
"log"
"net/http"
"github.com/gorilla/mux"
)
func main() {
router := mux.NewRouter()
router.HandleFunc("/hi", SayHi).Methods("GET") // 推荐显式限定方法
fmt.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")
}
? 补充建议:
- 使用
.Methods("GET")显式声明支持的 HTTP 方法,避免意外匹配; - 可添加
router.NotFoundHandler = http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { ... })自定义 404 响应; - 若需中间件(如日志、CORS),应在
router上链式调用(如router.Use(loggingMiddleware));
⚠️ 注意:mux.Router 本身实现了 http.Handler 接口,可直接作为处理器使用 —— 这是它能被 ListenAndServe 接收的关键前提。切勿遗漏此步,否则所有自定义路由都将失效。










