普通函数不能直接当http.Handler用，因为http.Handler是接口，要求实现ServeHTTP方法，而普通函数本身不实现该接口；必须通过http.HandlerFunc包装才能满足接口契约。
为什么普通函数不能直接当 http.Handler 用
因为 http.Handler 是个接口，只定义了一个 ServeHTTP(http.ResponseWriter, *http.Request) 方法；而普通函数（比如 func(w http.ResponseWriter, r *http.Request)）本身不是类型，更不实现该接口。Go 不会自动把函数“升格”为接口实现——这点和 Python 的 callable 或 JavaScript 的函数即对象完全不同。
用 http.HandlerFunc 包装是最直接的方式
http.HandlerFunc 是 Go 标准库提供的类型别名，它把符合 func(http.ResponseWriter, *http.Request) 签名的函数“强制”转成实现了 http.Handler 接口的值。它的底层就是靠实现 ServeHTTP 方法来调用你传入的函数。
- 写法简单：
http.HandlerFunc(yourFunc)即可得到一个合法的http.Handler - 常见于注册路由：
http.Handle("/api", http.HandlerFunc(myHandler)) - 注意：必须是精确签名，参数顺序、类型、指针与否都不能错；
*http.Request写成http.Request会编译失败 - 示例：
func hello(w http.ResponseWriter, r *http.Request) {
w.Write([]byte("Hello"))
}
// ✅ 正确
http.Handle("/hello", http.HandlerFunc(hello))
// ❌ 编译错误：cannot use hello (value of type func(http.ResponseWriter, *http.Request)) as http.Handler value in argument to http.Handle
在 http.ServeMux 或 Gin/echo 等框架中怎么用
标准 http.ServeMux 的 Handle 和 HandleFunc 都接受 http.Handler；但 HandleFunc 其实只是帮你做了包装——它内部就是调用了 http.HandlerFunc(f)。所以两种写法等价：
-
mux.HandleFunc("/path", handlerFunc)→ 自动包装 -
mux.Handle("/path", http.HandlerFunc(handlerFunc))→ 手动包装，更显式，也更适合嵌套或中间件链 - 第三方框架如 Gin 的
GET、Echo 的GET接收的是自己的 handler 类型，但底层仍依赖标准库的转换逻辑；如果你要对接原生http.Handler（比如集成 Prometheus 的InstrumentHandler），就必须显式用http.HandlerFunc
容易忽略的坑：闭包捕获变量引发的竞态
当你在循环里创建多个 handler 函数并闭包引用循环变量时，很容易意外共享同一个变量值——这不是接口转换的问题，但常出现在“转换后部署才发现行为异常”的场景中。
立即学习“go语言免费学习笔记（深入）”；
- 错误写法：
for _, path := range paths { http.Handle(path, http.HandlerFunc(func(...) {...})) }→ 所有 handler 可能都用最后一个path值 - 正确做法：用局部变量绑定，或用立即执行函数捕获
- 性能提示：每次调用
http.HandlerFunc(f)都只是类型转换，零分配、无开销；但若在 handler 内部频繁新建 goroutine 或分配大结构体，才会影响吞吐
真正卡住人的，往往不是“怎么转”，而是转完之后 handler 里读了错误的变量、没处理 r.Body 关闭、或者忘了设置 Content-Type 导致前端解析失败。
