结论：用 http.handlerfunc 包一层可将普通函数转为 http.handler，但签名必须严格匹配 func(http.responsewriter, *http.request)；否则编译报错。
直接说结论：用 http.HandlerFunc 包一层就能把普通函数转成 http.Handler，但必须确保函数签名严格匹配 func(http.ResponseWriter, *http.Request)；否则编译报错或运行时 panic。
为什么 http.HandleFunc 和 http.Handle 接收参数类型不同
http.HandleFunc 接收的是裸函数，http.Handle 接收的是实现了 ServeHTTP 方法的接口实例。底层其实是一回事：http.HandleFunc 内部会自动调用 http.HandlerFunc(f) 把函数转成接口类型。
-
http.HandleFunc("/path", myFunc)→ 自动包装为http.HandlerFunc(myFunc) -
http.Handle("/path", http.HandlerFunc(myFunc))→ 手动包装，等价但冗余 -
http.Handle("/path", myStruct{})→ 要求myStruct实现了ServeHTTP方法
HandlerFunc 转换失败的三个典型错误
常见于参数名、顺序、指针类型写错，Go 不做隐式转换，出错就是编译不通过。
- 写成
func(w *http.ResponseWriter, r *http.Request)—— 第一个参数不能是指针 - 写成
func(w http.ResponseWriter, r http.Request)——*http.Request缺少* - 写成
func(w http.ResponseWriter, r *http.Request) string—— 多了返回值，HandlerFunc必须无返回值
错误信息通常是：cannot use myFunc (type func(http.ResponseWriter, *http.Request) string) as type http.HandlerFunc
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
在中间件链中正确复用 HandlerFunc
中间件本质是“接收 http.Handler，返回新的 http.Handler”，所以你写的中间件函数必须返回 http.Handler 类型，而不是裸函数。
- ✅ 正确写法：
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { /* ... */ next.ServeHTTP(w, r) }) - ❌ 错误写法：
return func(w http.ResponseWriter, r *http.Request) { /* ... */ next.ServeHTTP(w, r) }—— 返回的是裸函数，类型不匹配 - ⚠️ 注意：如果中间件要嵌套，
next是http.Handler，只能调用next.ServeHTTP(w, r)，不能直接next(w, r)
go-restful 等框架里怎么用标准 HandlerFunc
像 go-restful 的 Filter 期望的是 restful.FilterFunction，不是 http.Handler。不能直接传 http.HandlerFunc。
- 要用
restful.HttpMiddlewareHandlerToFilter(auth)这类适配器函数做桥接 - 该适配器内部会把
http.Handler包装成restful.FilterFunction，并处理Request/ResponseWriter到restful.Request/Response的转换 - 如果你跳过适配器、强行传
http.HandlerFunc，会编译失败：类型不兼容，且上下文对象丢失
真正容易被忽略的是：HandlerFunc 只解决“函数→Handler”的转换，不解决“跨框架上下文传递”。不同框架的 Context、ResponseWriter 实现互不兼容，硬转只会 panic 或静默失效。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
