Go 1.22 ServeMux 怎么写带方法和通配符的路由

如果你还在每个处理器里手动判断 r.Method，再从 r.URL.Path 切字符串，Go 1.22 的 net/http.ServeMux 可以把这部分路由规则前移到模式本身。最小写法是 GET /articles/{id}：方法限制、路径变量和匹配范围都写在一行里。

一、先把 HTTP 方法和路径写进 ServeMux 模式

Go 1.22 的模式大致是 [METHOD ][HOST]/[PATH]。方法后至少要有一个空格，通配符必须是完整路径段。下面的注册同时覆盖了资源详情、资源创建和静态资源子树：

mux := http.NewServeMux()

// GET 只负责详情；{id} 只占一个路径段。
mux.HandleFunc("GET /articles/{id}", articleDetail)

// POST 与 GET 是两条不同的方法模式，处理器不必再次判断 r.Method。
mux.HandleFunc("POST /articles", createArticle)

// ... 通配符必须位于模式末尾，表示剩余的所有路径段。
mux.HandleFunc("GET /assets/{path...}", serveAsset)

方法模式是集合的一部分：没有方法的模式匹配所有方法，写了方法的模式范围更窄。特别地，GET 会连同 HEAD 一起匹配；POST、PUT 等其他方法则按精确方法匹配。

二、用 PathValue 读取单段和剩余路径

匹配成功后，变量值不需要自己切 URL.Path。处理器直接使用 r.PathValue("id") 或 r.PathValue("path")：

func articleDetail(w http.ResponseWriter, r *http.Request) {
    // id 是 /articles/{id} 捕获的单个路径段。
    id := r.PathValue("id")
    if id == "" {
        http.Error(w, "missing article id", http.StatusBadRequest)
        return
    }
    fmt.Fprintf(w, "article=%s\n", id)
}

func serveAsset(w http.ResponseWriter, r *http.Request) {
    // path 可以包含多个段，例如 css/app.css。
    path := r.PathValue("path")
    http.ServeFile(w, r, filepath.Join("public", path))
}

{id} 在下一个斜杠前结束，适合编号、用户名这类单段值；{path...} 必须放在末尾，适合目录和文件名。路由匹配会按路径段处理转义，不能把 %2F 简单当成普通斜杠来推断边界。

三、用最具体匹配处理路由重叠

ServeMux 不靠注册先后决定重叠路由，而是选择匹配请求集合更小的模式。例如下面两条都能覆盖 /articles/latest，字面量模式比单段通配符更具体，因此它会优先命中：

// 字面量只匹配 latest，因此比 {id} 更具体。
mux.HandleFunc("GET /articles/latest", latestArticle)
mux.HandleFunc("GET /articles/{id}", articleDetail)

这条规则也解释了方法的优先级：GET /articles/{id} 比没有方法的 /articles/{id} 更具体。相反，如果两个模式各自在不同位置更具体，例如 /articles/{id} 与 /{resource}/latest，它们互不包含，注册时会被视为冲突并触发 panic。不要靠交换注册顺序解决，应该重新设计资源层级或合并处理逻辑。

四、上线前检查版本、尾斜杠和方法错误

这套语法从 Go 1.22 开始生效。运行环境仍是 Go 1.21 时，{id} 只是普通字符；如果必须暂时保留旧行为，可以了解 httpmuxgo121=1，但迁移时更应该先统一构建机和生产机版本。

以斜杠结尾的子树模式会把请求重定向到带斜杠的路径，例如注册 /assets/ 后访问 /assets。需要只匹配一个精确尾斜杠时使用 /assets/{$}。如果路径匹配但方法没有对应处理器，ServeMux 会返回 405 Method Not Allowed，并在 Allow 头中提示可用方法；完全没有匹配路径才是 404。

排查时先看三件事：模式是否真的运行在 Go 1.22 以上，通配符是否为完整段且放置在末尾，冲突是否发生在注册阶段。把这三项分开，通常比继续给处理器增加字符串判断更快。

相关问题

GET 模式需要另外注册 HEAD 吗？

通常不需要。ServeMux 的 GET 模式也匹配 HEAD；只有需要不同 HEAD 行为时，才考虑单独安排处理器。

{id} 和 {path...} 能互换吗？

不能。前者只吃一个路径段，后者必须位于末尾并覆盖剩余路径，二者的匹配集合不同。

为什么两条路由还没收到请求就 panic？

冲突是在注册模式时检查的。若两个模式有重叠但谁都不比谁具体，ServeMux 会直接拒绝注册，避免结果依赖初始化顺序。

参考：Go 1.22 Routing Enhancements、net/http ServeMux 文档、Go 1.22 发布说明。