当前位置：首页 > 文章列表 > Golang > Go问答 > Go ServeMux 注册通配符后怎么读取路径参数

Go ServeMux 注册通配符后怎么读取路径参数

来源：17golang原创 2026-09-06 05:27:34 0浏览收藏

在 Go 1.22 及以上版本里，ServeMux 的命名通配符不是靠手动切字符串读取，而是直接调用 r.PathValue("参数名")。例如注册 GET /users/{id} 后，请求 /users/u-42 会让 r.PathValue("id") 返回 u-42。如果拿到空字符串，优先检查请求是否真的经过这个 ServeMux，以及读取的名字是否和模式完全一致。

最小可用写法是：在 ServeMux 模式中声明 {id}，在对应处理器里使用 r.PathValue("id")。需要跨越多个路径段时改用末尾的 {path...}。

要点速览

{id} 只匹配一个路径段，{path...} 匹配末尾的剩余路径。
PathValue 只能读取匹配模式中的命名通配符，名称拼错会得到空字符串。
请求应交给 mux.ServeHTTP 分发；单独调用 mux.Handler(r) 不会填充路径参数。

Go ServeMux 通配符与 PathValue 的最小写法

先把路由模式和参数名写在一起，再在处理器内部读取同名参数。下面的示例只做一件事：从用户路径中取出 id，并把它放进响应。代码中的 GET 方法前缀和命名通配符都属于 Go 1.22 引入的新版 ServeMux 模式语法。

package main

import (
	"fmt"
	"net/http"
)

func main() {
	mux := http.NewServeMux()

	// {id} 是命名通配符，只占用 /users/ 后面的一个路径段。
	mux.HandleFunc("GET /users/{id}", func(w http.ResponseWriter, r *http.Request) {
		id := r.PathValue("id")
		if id == "" {
			// 空参数通常表示模式或分发链路没有按预期生效。
			http.NotFound(w, r)
			return
		}
		fmt.Fprintf(w, "user=%s", id)
	})

	// 让 ServeMux 负责匹配模式并把命名参数写入请求。
	if err := http.ListenAndServe(":8080", mux); err != nil {
		panic(err)
	}
}

访问 http://localhost:8080/users/u-42 时，处理器会得到 u-42。这里不要改成读取 r.URL.Query().Get("id")：查询参数和路径参数是两套输入，前者对应 /users?id=u-42，并不会读取 /users/u-42 中的内容。

Go ServeMux 将 GET users id 路径映射到 Request PathValue 的静态关系图 — 图1：看清路由模式、请求路径、命名通配符和 PathValue 之间的静态关系。

单段参数和剩余路径要用不同通配符

普通通配符只匹配一个路径段，遇到下一个斜杠就结束；末尾带三个点的通配符用于读取剩余路径。文件、对象键和文档路径这类参数，经常需要后者。

mux.HandleFunc("GET /files/{path...}", func(w http.ResponseWriter, r *http.Request) {
	// {path...} 必须位于模式末尾，返回 docs/go/route.md 这样的剩余路径。
	path := r.PathValue("path")
	if path == "" {
		// 空值代表没有匹配到命名通配符，不要把它当成根目录文件。
		http.NotFound(w, r)
		return
	}
	fmt.Fprintf(w, "file=%s", path)
})

可以用下面的表快速判断模式：

模式	匹配范围	示例返回值
`/users/{id}`	一个路径段	`u-42`
`/files/{path...}`	末尾全部剩余路径	`docs/go/route.md`
`/files/`	子树匹配，通配符没有名字	不能用自定义名称读取