Go ServeMux 两条路由同时匹配时怎么判断优先级

Go 1.22 之后，net/http.ServeMux 的答案可以先记成一句话：两条路由都能匹配时，匹配请求集合更小的那条优先；注册先后不参与判断。只有当两个模式互相覆盖、谁也不是谁的子集时，才是冲突，注册第二条时会触发 panic。

先用请求集合判断谁更具体

不要先数字符串长度，也不要猜哪一条是“后注册覆盖前注册”。把模式看成请求集合更稳：字面量限制最窄，单段通配符放宽一个路径段，... 通配符还会继续覆盖后面的段。若模式 A 匹配的每个请求都属于模式 B，且 B 还能匹配更多请求，A 就是更具体的模式。

关键不是 id 和 name 叫什么，而是它们覆盖的请求集合。通配符改名不会改变优先级。尾部斜杠表示子树；如果只想匹配恰好带斜杠的路径，可以使用 /reports/{$}。

方法模式会把可匹配请求集合继续缩小

ServeMux 的模式可以包含方法、主机和路径。没有方法的模式覆盖所有方法；写成 GET /posts/{id} 后，只覆盖 GET 和 HEAD。其他方法如 POST、DELETE 则必须精确匹配。因此，比较时要把方法和路径一起看，不能只比较 URL。

mux := http.NewServeMux()

// 固定路径只覆盖一个资源名，优先于同方法下的任意 id。
mux.HandleFunc("GET /posts/latest", latestHandler)

// 单段通配符覆盖更多 GET/HEAD 请求。
mux.HandleFunc("GET /posts/{id}", postHandler)

// PathValue 读取当前请求命中的 id；未命中该模式时不会进入这里。
func postHandler(w http.ResponseWriter, r *http.Request) {
    id := r.PathValue("id")
    fmt.Fprintln(w, id)
}

在这组同方法模式中，请求 GET /posts/latest 会落到固定路径；GET /posts/42 才会落到通配符。若把第一条改成不带方法的 /posts/latest，它还会覆盖 DELETE 等其他方法，和 GET /posts/{id} 之间就不一定存在子集关系，不能简单说“固定路径必胜”。

互不包含就不是优先级而是冲突

下面两条模式都能匹配 /posts/latest：

// 资源名可以是任意一段。
mux.HandleFunc("/posts/{id}", byID)

// 第一段可以是任意值，但最后一段固定为 latest。
mux.HandleFunc("/{resource}/latest", latestByResource)

// 两条模式各自还有对方匹配不到的请求，ServeMux 会认为它们冲突。

第一条能匹配 /posts/42，第二条能匹配 /users/latest；双方都各有独占范围，所以不存在“谁更具体”。ServeMux.Handle 或 HandleFunc 注册冲突模式时会 panic。这个行为与注册顺序无关，生产代码不应靠交换两行注册语句碰运气。

主机模式有一个兼容性例外：如果其他条件会冲突，而一条带主机、另一条不带主机，带主机的模式优先。它仍然不能替代正常的路径建模；更常见的修复方式是让两个模式形成清晰的包含关系，或拆成不同的路径前缀。

注册前的路由检查清单

1. 先写出每条模式的请求集合：方法、主机、每个路径段分别限制什么。
2. 检查是否是严格子集；是则更具体者优先，不是则继续做冲突检查。
3. 确认 {name} 只占一段，{name...} 只能放在末尾，{$} 表示路径结束。
4. 如果项目从 Go 1.21 升级，重点复查带花括号的旧字面量和转义路径；httpmuxgo121=1 是兼容开关，不是新规则的替代品。

还可以在单元测试中调用 mux.Handler(r)，检查返回的 pattern 是否等于预期。它能帮助确认静态建模，但不会替你修复注册时的冲突；冲突应在路由表设计阶段解决。

常见问题

ServeMux 会按最后注册的路由匹配吗？

不会。Go 1.22 之后按“最具体模式”选择，注册顺序不改变合法模式的匹配结果。

通配符名字不同会影响优先级吗？

不会。{id} 和 {name} 的名字只影响 PathValue 读取，不改变请求集合。

两个模式同时命中但没有 panic，应该怎么判断？

把方法、主机和路径合并成完整请求集合，判断一方是否严格包含另一方；只要是子集关系，就由更具体者处理。

相关事实可继续查阅 net/http 官方文档 与 Go 1.22 路由增强说明。实际改路由时，先画清请求集合，再写注册代码，通常比调换注册顺序更快定位问题。