因为http.HandleFunc要求第二个参数严格匹配func(http.ResponseWriter, http.Request)类型，任何签名偏差（如缺、多返回值、参数顺序错）都会导致编译失败，而非类型转换问题。
为什么直接传函数名给 http.HandleFunc 会报错
因为 http.HandleFunc 第二个参数要求是 func(http.ResponseWriter, *http.Request) 类型，而普通函数如果签名不完全匹配（比如多了一个参数、少了一个指针星号、返回值不为 void），Go 编译器会直接拒绝——不是“类型转换失败”，而是“根本不是那个类型”。常见错误现象是：cannot use myHandler (type func(string) string) as type func(http.ResponseWriter, *http.Request) in argument to http.HandleFunc。
解决思路不是“强制转换”，而是用闭包或适配器包装，让签名对齐。
用匿名函数包裹实现最简适配
这是最快上手的方式：在注册路由时现场构造一个符合签名的函数，内部调用你的业务逻辑。
- 你的原始函数如
func greet(name string) string，不能直接传；但可以写成：http.HandleFunc("/hello", func(w http.ResponseWriter, r *http.Request) { name := r.URL.Query().Get("name") result := greet(name) fmt.Fprint(w, result) }) - 注意：
r.URL.Query().Get是安全的，空值返回空字符串，无需额外判空 - 这种写法适合简单逻辑；一旦要复用或测试，就该抽离成命名函数
定义显式 handler 函数并手动调用
把适配逻辑提取出来，变成可复用、可测试的命名函数，而不是每次都写匿名函数。
立即学习“go语言免费学习笔记（深入）”；
- 例如你有一个
func handleUserDetail(id string) (string, error)，可封装为： func userDetailHandler(w http.ResponseWriter, r *http.Request) { id := strings.TrimPrefix(r.URL.Path, "/user/") if id == "" { http.Error(w, "missing id", http.StatusBadRequest) return } result, err := handleUserDetail(id) if err != nil { http.Error(w, err.Error(), http.StatusInternalServerError) return } fmt.Fprint(w, result) } // 注册时直接传函数名（它现在签名已正确） http.HandleFunc("/user/", userDetailHandler)- 注意路径匹配逻辑：Go 的
http.ServeMux对/user/这种带尾斜杠的注册，会匹配所有以该前缀开头的路径，所以需手动截取 - 不要在
userDetailHandler里用http.Redirect或http.Error后还继续执行，容易写出重复写 response header 的 panic
用结构体方法实现带状态的 handler
当 handler 需要访问数据库连接、配置或缓存等共享资源时，用结构体字段承载依赖，比全局变量更清晰可控。
- 定义结构体：
type UserHandler struct { db *sql.DB cache *redis.Client } - 实现方法（注意接收者必须是指针才能满足
http.Handler接口）：func (h *UserHandler) ServeHTTP(w http.ResponseWriter, r *http.Request) { id := strings.TrimPrefix(r.URL.Path, "/api/user/") row := h.db.QueryRow("SELECT name FROM users WHERE id = ?", id) // ... 处理逻辑 } - 注册时用
http.Handle（不是HandleFunc）：handler := &UserHandler{db: db, cache: cache} http.Handle("/api/user/", handler) - 关键点：
http.Handle接收的是实现了ServeHTTP方法的任意类型，而http.HandleFunc只认函数字面量；别混用
真正容易被忽略的是路径匹配细节和错误处理时机：注册 /user 和 /user/ 行为完全不同，前者只匹配精确路径，后者匹配子路径；而 http.Error 内部会调用 w.WriteHeader，之后再写 body 没问题，但再调一次 http.Error 就会 panic。
