Go http.Request.Pattern 怎样读取当前匹配的路由模式

如果 handler 里需要知道“这次请求命中了哪条 ServeMux 路由”，可以直接读取 r.Pattern。它保存的是实际匹配到的路由模式，例如请求路径是 /orders/42 时，模式可能是 GET /orders/{id}。需要注意，Pattern 记录的是路由匹配结果，不是请求 URL；如果请求没有经过 ServeMux 匹配，它就是空字符串。

官方资料：https://pkg.go.dev/net/http#Request

最小用法是在通过 http.ServeMux 分发的 handler 中读取 r.Pattern；动态片段的实际值则用 r.PathValue 读取。两者分别表示“规则”和“值”，不要混为一谈。

Request.Pattern 到底保存什么

http.Request.Pattern 是一个字符串字段，表示匹配请求的 ServeMux 模式。它可能包含 HTTP 方法、主机和路径，例如 GET /orders/{id}。请求 URL 中的 /orders/42 是实际路径，Pattern 则是路由注册时使用的规则。

这个区别很适合做访问日志、接口维度统计或路由级耗时指标：路径变量不会让每个订单号都变成一个新的指标标签。若还需要变量值，再调用 PathValue，不要尝试从 Pattern 反向解析业务参数。

用 ServeMux 注册一条可观察的路由

下面的示例注册一个带 HTTP 方法和路径通配符的路由。handler 中分别打印模式和通配符值，方便理解两个字段的职责。

package main

import (
    "fmt"
    "log"
    "net/http"
)

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

    // 注册带方法和路径变量的路由，模式会成为 Request.Pattern 的来源。
    mux.HandleFunc("GET /orders/{id}", func(w http.ResponseWriter, r *http.Request) {
        pattern := r.Pattern
        orderID := r.PathValue("id")

        // Pattern 是规则，PathValue 是本次请求匹配到的变量值。
        log.Printf("pattern=%q order_id=%q", pattern, orderID)
        fmt.Fprintf(w, "pattern=%s order_id=%s", pattern, orderID)
    })

    // 让 ServeMux 负责分发请求，handler 才能拿到匹配结果。
    log.Fatal(http.ListenAndServe(":8080", mux))
}

当请求 GET /orders/42 到达这个 mux 时，handler 里可得到：

• r.Pattern：GET /orders/{id}；
• r.PathValue("id")：42。

如果只想记录稳定的路由维度，使用 r.Pattern；如果要查询订单，才使用 PathValue("id") 并继续做参数校验。

为什么有时 Pattern 是空字符串

官方定义明确：请求没有针对某个模式完成匹配时，Pattern 为空。最常见的边界有三类。

1. 测试中直接调用 handler，而不是调用 mux 的 ServeHTTP；
2. 自定义分发器把请求直接交给 handler，没有设置 ServeMux 的匹配信息；
3. 读取的是客户端发出的请求对象，它代表出站请求，不是服务器端的路由匹配结果。

因此，看到空字符串不能简单判断“路由不存在”。先确认请求是否经过目标 mux，再确认代码读取的是服务端 handler 收到的 request。

测试时要让请求真正经过 mux

如果测试直接调用 handler，Pattern 为空是符合定义的。要覆盖真实路由分发，可以把请求交给 mux：

func TestOrderRoutePattern(t *testing.T) {
    mux := http.NewServeMux()

    // 注册与生产代码相同的路由，测试匹配后的 Pattern 和 PathValue。
    mux.HandleFunc("GET /orders/{id}", func(w http.ResponseWriter, r *http.Request) {
        if r.Pattern != "GET /orders/{id}" {
            t.Fatalf("unexpected pattern: %q", r.Pattern)
        }
        if got := r.PathValue("id"); got != "42" {
            t.Fatalf("unexpected id: %q", got)
        }
    })

    req := httptest.NewRequest(http.MethodGet, "/orders/42", nil)
    rec := httptest.NewRecorder()

    // 必须通过 mux 分发，Request.Pattern 才会反映 ServeMux 的匹配结果。
    mux.ServeHTTP(rec, req)
}

这个测试片段需要导入 net/http/httptest 和 testing。关键不是测试工具本身，而是调用链：httptest.NewRequest 只负责创建请求，真正填入路由匹配信息的是 mux.ServeHTTP。

用 Pattern 做日志和指标维度

在生产服务中，推荐把它作为稳定的路由标签：

func accessLog(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        next.ServeHTTP(w, r)

        pattern := r.Pattern
        if pattern == "" {
            // 自定义分发或异常入口没有匹配模式，使用统一占位值。
            pattern = ""
        }
        log.Printf("method=%s pattern=%s path=%s", r.Method, pattern, r.URL.Path)
    })
}

建议把 Pattern 用在日志、耗时统计和路由级错误聚合中。不要用它代替权限判断，也不要把 URL.Path 的原始内容直接作为高基数指标标签；路径变量应单独记录、脱敏或采样。

快速排查清单

常见问题

Pattern 能直接替代 URL.Path 吗？

不能。Pattern 是注册的匹配规则，URL.Path 是请求携带的实际路径；一个用于归类，一个用于处理本次请求。

Pattern 为空是不是说明请求返回了 404？

不一定。直接调用 handler、自定义分发或读取客户端请求时都可能为空。是否 404 要看实际响应和分发逻辑。

怎样同时拿到路由和路径变量？

在经过 ServeMux 的 handler 中读取 r.Pattern，再用 r.PathValue("变量名") 读取对应值。

一句话总结：Request.Pattern 读取的是 ServeMux 的匹配规则，最可靠的使用位置是已经由 mux 分发的服务端 handler；遇到空字符串时先检查请求链路，而不是盲目改写 URL。