net/http.ServeMux 不适合 RESTful 路由，因其仅支持固定路径或前缀匹配，无法处理路径变量（如 /users/{id}）、区分 HTTP 方法、实现优先级匹配；需用 gorilla/mux 等第三方路由器或自定义 Handler。
Go 标准库 net/http 本身不提供路径参数提取和路由树匹配能力，直接用 http.ServeMux 只能做前缀匹配，无法支持 /users/{id} 这类动态路由。真要写 Web 服务，得用第三方路由器或自己实现匹配逻辑。
为什么 http.ServeMux 不适合 RESTful 路由
http.ServeMux 的 Handle 和 HandleFunc 仅支持固定路径或前缀（如 /api/），遇到以下情况就失效：
- 路径含变量：
/posts/123和/posts/456都该走同一 handler，但ServeMux会当作两个不同路径 - 方法区分：同一个路径
/users，GET和POST需不同处理，ServeMux不检查req.Method - 路由顺序无意义：注册先后不影响匹配优先级，无法实现“更具体路径优先”
用 gorilla/mux 实现带参数的路由匹配
gorilla/mux 是最常用的 Go 路由器，支持路径变量、正则约束、方法限定、子路由等。安装后即可使用：
go get -u github.com/gorilla/mux
基本用法示例：
立即学习“go语言免费学习笔记（深入）”；
package main
import (
"fmt"
"log"
"net/http"
"github.com/gorilla/mux"
)
func main() {
r := mux.NewRouter()
// 匹配 /users/123 → 提取 id=123
r.HandleFunc("/users/{id:[0-9]+}", func(w http.ResponseWriter, r *http.Request) {
vars := mux.Vars(r)
fmt.Fprintf(w, "User ID: %s", vars["id"])
}).Methods("GET")
// 匹配 /api/v1/posts，且只响应 POST
r.HandleFunc("/api/v1/posts", func(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(http.StatusCreated)
w.Write([]byte("Post created"))
}).Methods("POST")
log.Fatal(http.ListenAndServe(":8080", r))
}
关键点：
-
{id:[0-9]+}中的正则部分可省略，但建议显式写出，避免意外匹配空字符串 -
mux.Vars(r)返回map[string]string，只包含当前路由定义的变量，不包含查询参数 -
.Methods("GET", "PUT")必须显式调用，否则默认接受所有方法（可能引发安全问题）
自定义路由匹配器：何时该自己写
如果项目极轻量（比如 CLI 工具内置 HTTP 管理端口），或需要特殊匹配逻辑（如按 Host + Path 组合路由、忽略大小写、通配符 *.api.example.com），gorilla/mux 可能太重。这时可基于 http.Handler 接口自己实现：
type CustomRouter struct{}
func (r *CustomRouter) ServeHTTP(w http.ResponseWriter, req *http.Request) {
path := req.URL.Path
switch {
case req.Method == "GET" && path == "/health":
w.WriteHeader(http.StatusOK)
w.Write([]byte("ok"))
case req.Method == "POST" && len(path) > 8 && path[:8] == "/upload/":
id := path[8:]
if id != "" {
fmt.Fprintf(w, "Upload ID: %s", id)
return
}
default:
http.NotFound(w, req)
}
}
这种写法的问题很明确：
- 路径解析靠字符串操作，易出错（比如没处理 trailing slash）
- 无法复用中间件（日志、鉴权等需手动嵌套）
- 没有路由调试能力（比如打印所有已注册路径）
所以除非有明确约束（二进制体积、依赖最小化），否则不建议绕过成熟路由器。
真正容易被忽略的是：路径变量提取后，**类型转换和校验必须在 handler 内完成**——mux.Vars 只返回字符串，{id:[0-9]+} 保证了非空数字，但不保证在 int 范围内；如果后续要传给数据库查询，还得做 strconv.Atoi 并检查错误，不能假设正则就等于业务有效。
