Go http.ServeMux.PathValue 怎样读取路由参数

如果路由已经写成 GET /users/{id}，处理器里不需要再手动切分 URL：直接调用 r.PathValue("id") 就能读取命名通配符。关键前提是请求确实经过支持通配符的 http.ServeMux 匹配；如果测试里只是手动构造 httptest.NewRequest，参数不会凭空出现。

官方文档：https://pkg.go.dev/net/http#Request.PathValue

下面只讨论标准库路由模式、单段与尾通配符、参数读取和测试注入，不引入第三方路由框架。

ServeMux 模式怎样把参数交给处理器

先把参数名写进模式，再在处理器中用同名字符串读取。模式中的 {id} 表示一个路径段，PathValue("id") 读取的就是这个名字对应的值。

package main

import (
	"fmt"
	"net/http"
)

func main() {
	mux := http.NewServeMux()
	// 用命名通配符接收一个用户 ID；它只占一个路径段。
	mux.HandleFunc("GET /users/{id}", func(w http.ResponseWriter, r *http.Request) {
		// 参数名必须和模式里的 {id} 完全对应。
		id := r.PathValue("id")
		fmt.Fprintf(w, "user=%s", id)
	})
	_ = http.ListenAndServe(":8080", mux)
}

访问 /users/42 时，处理器读取到的 id 是 42。这里的参数来源是 ServeMux 对请求路径的匹配结果，不是 URL.Query()，所以 /users/42?id=7 中的 7 仍属于查询参数，不能用 PathValue("id") 读取。

单段通配符和尾通配符有什么区别

单段通配符适合用户 ID、订单号这类不包含路径分隔符的值；尾通配符适合把剩余路径作为一个整体交给处理器。两者的参数名仍然通过 PathValue 读取。

mux.HandleFunc("GET /users/{id}", func(w http.ResponseWriter, r *http.Request) {
	// {id} 只对应一个路径段，例如 42。
	fmt.Fprintln(w, r.PathValue("id"))
})

mux.HandleFunc("GET /assets/{path...}", func(w http.ResponseWriter, r *http.Request) {
	// {path...} 对应剩余路径，例如 css/app.css。
	fmt.Fprintln(w, r.PathValue("path"))
})

不要把尾通配符误当成普通字符串。若客户端请求 /assets/css/app.css，PathValue("path") 返回的是剩余路径；若把读取名写成 PathValue("id")，因为模式里没有名为 id 的变量，得到的就是空字符串。

官方路由增强说明：https://go.dev/blog/routing-enhancements。选择模式时，静态路径和更具体的模式优先级由 ServeMux 处理；不要在处理器中再复制一套“哪个路由更具体”的判断。

为什么测试里 PathValue 经常读到空字符串

最常见的原因是测试直接把请求交给处理器，没有让 ServeMux 匹配模式。此时 URL 中虽然有 /users/42，Request 也不会自动推断出 id。单测可以显式注入参数：

func TestUserHandler(t *testing.T) {
	r := httptest.NewRequest(http.MethodGet, "/users/42", nil)
	// 直接测试处理器时，手动补上 ServeMux 原本会设置的路径值。
	r.SetPathValue("id", "42")
	recorder := httptest.NewRecorder()
	userHandler(recorder, r)

	if got := recorder.Body.String(); got != "user=42" {
		// 失败信息要同时保留期望值和实际值，方便定位参数注入问题。
		t.Fatalf("body = %q, want %q", got, "user=42")
	}
}

另一种写法是让测试请求经过真实的 ServeMux，这样参数来自和生产相同的模式匹配。直接测处理器时用 SetPathValue 更聚焦；测路由注册和优先级时则应把 mux 也放进测试范围。

读取结果为空时，按下面顺序判断：

落地时保留哪条边界

把路径参数当作路由匹配结果，把查询参数交给 URL.Query()，把测试注入和生产匹配分开。这样处理器只关心已经命名的输入，不必重复解析斜杠、转义和路由优先级。

PathValue 能读取查询参数吗？

不能。PathValue 只读取模式中的路径通配符；查询参数使用 r.URL.Query().Get("key")。

没有通配符时调用 PathValue 会怎样？

会得到空字符串。它不是错误返回值，所以如果空值有业务含义，应在路由设计或处理器入口处明确区分。

应该手动 strings.Split URL.Path 吗？

标准 ServeMux 已经负责模式匹配和命名参数。除非业务确实需要另一种路径语义，否则优先读取 PathValue，避免在处理器里维护重复解析规则。