Go net/http ServeMux 怎样用通配符读取路径值

如果你在 Go 1.22 及更高版本使用标准库路由，最直接的写法是把路径参数写进 ServeMux 模式，再在处理器中调用 r.PathValue("id")。例如 GET /posts/{id} 捕获一个路径段，/files/{path...} 捕获末尾的全部路径。需要特别留意：这是 Go 1.22 引入的模式语法，返回值按路径段解码，不能把它当成旧版的普通字符串模式。

官方参考：https://pkg.go.dev/net/http

先把单段通配符写对

ServeMux 的单段参数是完整路径段，名称需要符合 Go 标识符规则。下面的 {id} 不会跨越下一个字面斜杠，因此适合文章编号、用户标识或单个文件名；方法前缀则把请求方法约束放在路由层。

package main

import (
	"fmt"
	"net/http"
)

func main() {
	mux := http.NewServeMux()
	// 方法与路径一起声明，让处理器只接收 GET /posts/{id}。
	mux.HandleFunc("GET /posts/{id}", func(w http.ResponseWriter, r *http.Request) {
		// PathValue 读取模式中的命名通配符，返回值已经按路径段解码。
		id := r.PathValue("id")
		if id == "" {
			// 空值不能直接当成有效编号，先返回客户端错误。
			http.Error(w, "missing post id", http.StatusBadRequest)
			return
		}
		fmt.Fprintf(w, "post=%s", id)
	})
	_ = http.ListenAndServe(":8080", mux) // 生产服务应处理返回错误并配置超时。
}

这段写法的关键不在于把参数取出来，而在于让参数的边界由模式表达：/posts/123/comments 不会被这个处理器误当成一个 id。若还需要子资源，应单独注册更具体的模式。

尾部通配符适合剩余路径

当资源本身包含多级路径时，使用 {path...}。它可以包含斜杠，只能写在模式最后；例如 /files/{path...} 可以接收 docs/go/route.md。如果使用普通的 {path}，匹配会在第一个斜杠前结束。

mux.HandleFunc("GET /files/{path...}", func(w http.ResponseWriter, r *http.Request) {
	// 尾部通配符包含剩余路径，适合把层级路径交给后续资源定位逻辑。
	path := r.PathValue("path")
	if path == "" {
		// 空路径表示没有拿到有效的剩余路径，避免继续拼接文件位置。
		http.Error(w, "missing file path", http.StatusBadRequest)
		return
	}
	fmt.Fprintln(w, path)
})

这里的 path 不是经过安全检查的本地文件名，也不是授权结果。若后续要映射到文件系统或对象存储，仍要单独做允许范围、权限和审计设计；ServeMux 只负责路由匹配。

解码、冲突和版本边界

PathValue 返回的是已解码的通配符值。例如路径中的 a%2Fb 会作为一个路径段对应到 a/b；它不会因此改变模式中的分隔规则。不要再用字符串拼接方式猜测原始转义形式。

多个模式同时匹配时，ServeMux 选择更具体的模式，例如字面量 /posts/latest 比 /posts/{id} 更具体。两个模式互相覆盖却无法判断谁更具体时，注册阶段会报告冲突。Handle 或 HandleFunc 也会因非法模式直接 panic，所以模式应在启动阶段集中注册。

Go 1.21 中花括号仍可按字面处理，Go 1.22 起则表示通配符；如果维护旧程序，必须把升级后的模式行为纳入兼容测试。官方提供 GODEBUG=httpmuxgo121=1 作为旧行为开关，但它是启动时读取的兼容选项，不应替代长期迁移。

常见问题

为什么 PathValue 读到的是空字符串？

常见原因是当前请求并未由带该名称的 ServeMux 模式匹配，或者名称拼写与模式不同。也要注意，直接调用 mux.Handler(r) 不会填充请求的通配符值。

单段通配符能匹配带斜杠的值吗？

不能。需要包含斜杠的剩余路径时，把通配符写成末尾的 {name...}；如果只是一个编码后的 %2F，则按路径段解码规则理解，不要把它与实际分隔斜杠混为一谈。

小结：把参数边界写进 ServeMux 模式，再用 PathValue 读取，是标准库路由的清晰用法。先分清单段与尾部通配符，再检查解码、冲突和 Go 版本，就能避免把路由问题转成处理器里的字符串猜测。