如何在Golang中将函数作为Map的Value实现简单的路由分发

在 Go 里用 Map 做路由分发时，有个坑很多人踩过——不能直接用函数类型当 Value。为啥呢？因为所有路由函数的签名必须统一，比如都得是 func(http.ResponseWriter, *http.Request)。一旦你往里塞个签名不一样的函数，比如带 context 或者返回 error 的那种，编译器立刻报错。这不是语法错，是类型不匹配。最常见的报错信息是：cannot use func(http.ResponseWriter, *http.Request) as func() value in map。

所以，务必记住几点：第一，所有 handler 统一签名，推荐用标准 net/http 的 func(http.ResponseWriter, *http.Request)；第二，想玩中间件或者注入 context，别动签名，改用闭包包装——先写好业务函数，再拿匿名函数适配成标准签名；第三，别图省事用 interface{} 存函数，运行时类型断言容易 panic，还丢掉了编译期检查。

如何声明和初始化路由 map

最稳妥的方式，是显式定义类型别名。别嫌麻烦，这样做既能提高可读性，也能保证复用性——写出来的代码，自己三个月后看还能秒懂：

type HandlerFunc func(http.ResponseWriter, *http.Request)

var router = map[string]HandlerFunc{
    "/home": homeHandler,
    "/api/user": userHandler,
}

这里有几个细节：路径字符串是 key，必须精确匹配，不支持通配符或前缀匹配；value 是函数变量名，不是调用表达式——写成 "/home": homeHandler() 就踩坑了，会立刻执行函数并把返回值（通常是 void）塞进去，而不是存函数本身。

• key 用字符串字面量，避免拼写错误；建议统一小写 + 斜杠开头
• 初始化时函数名不加括号，这属于新手高频错误
• map 声明可以放在包级作用域，也可以在函数内局部初始化；如果需要动态增删路由，建议用指针或封装结构体

怎么安全地从 map 中取函数并执行

直接写 router[path](w, r) 很危险：key 不存在时返回 nil，调 nil 函数直接 panic。正确做法是先用 if val, ok := map[key] 判断一下：

if handler, ok := router[r.URL.Path]; ok {
    handler(w, r)
} else {
    http.Error(w, "Not Found", http.StatusNotFound)
}

别觉得多写两行代码麻烦——这能防住服务崩溃。几个建议：

• 永远用 if val, ok := map[key] 形式取值，别省略 ok
• 404 处理逻辑单独抽成函数，比如 notFoundHandler(w, r)，主流程保持清爽
• 如果路由量大，考虑 sync.RWMutex 包裹 map——前提是确实需要运行时动态注册或删除路由

为什么不用标准 http.ServeMux 而自己搞 map

自己用 map 实现路由，只适合极简场景：比如 CLI 工具里内置的 HTTP server、测试 mock server、或者嵌入式设备上跑的轻量服务。它不处理路径参数（/user/:id）、不支持子路由、不自动处理 HEAD/OPTIONS、也不带中间件链。如果项目里已经依赖 net/http，用 http.ServeMux 省心得多：

mux := http.NewServeMux()
mux.HandleFunc("/home", homeHandler)
mux.HandleFunc("/api/user", userHandler)
http.ListenAndServe(":8080", mux)

自己写 map 的唯一优势在于完全可控、没有隐藏逻辑、便于单元测试打桩。真要扩展，别硬改 map，直接换第三方路由器比如 gorilla/mux 或 chi——底层还是 map + trie，但匹配逻辑和生命周期管理更成熟。自己实现时最容易忽略的是请求方法校验（GET/POST 混用），map 本身不记录 method，得靠 handler 内部判断，或者额外封装一个结构体来兜住。