Go ServeMux路径尾斜杠重定向规则的验证方法

Go 的 http.ServeMux 把以斜杠结尾的模式视为一个子树。例如注册 /docs/ 后，请求 /docs 默认不会直接进入子树 handler，而是收到指向 /docs/ 的重定向；只有再注册精确的 /docs，才能覆盖这个行为。排查时不要只看最终页面，要先检查响应状态、Location 和实际命中的模式。

官方地址：https://pkg.go.dev/net/http

先把 /docs 与 /docs/ 看成两种匹配意图

/docs 只描述一个路径；/docs/ 则描述以该前缀开头的子树，包含 /docs/guide 等后续路径。ServeMux 发现请求正好落在子树根、但缺少尾斜杠时，会生成内部重定向 handler，将路径规范化到带斜杠的形式。这个规则不是业务 handler 写的 301，也不是浏览器补全地址。

用 httptest 读取重定向的真实边界

测试时直接把请求交给 mux，并使用 recorder 保留第一跳响应。这样不会被 http.Client 自动跟随重定向干扰，能明确看到 /docs 的响应和目标地址。

package main

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

func main() {
    mux := http.NewServeMux()
    mux.HandleFunc("/docs/", func(w http.ResponseWriter, r *http.Request) {
        // 子树 handler 只负责处理已经带尾斜杠的路径
        fmt.Fprintln(w, "docs subtree")
    })

    req := httptest.NewRequest(http.MethodGet, "http://example.test/docs", nil)
    rec := httptest.NewRecorder()
    mux.ServeHTTP(rec, req)

    // 读取第一跳，避免客户端自动跟随后只看到最终的 200
    fmt.Println(rec.Code)
    fmt.Println(rec.Header().Get("Location"))
}

// 输出示意：
// 301
// /docs/

这里的关键不是把 301 写死到业务逻辑里，而是确认“请求缺少子树模式要求的尾斜杠”。如果测试使用真实客户端，应关闭自动跟随；否则客户端会再次请求 /docs/，测试结果只剩下 handler 返回的成功状态。

需要保留无尾斜杠入口时，注册精确路径覆盖默认规则

有些接口希望 /docs 返回索引内容，或者希望旧地址不发生跳转。这时要显式注册两个模式，并在测试中分别断言它们的结果。精确路径注册不会取消 /docs/guide 对子树 handler 的匹配。

mux.HandleFunc("/docs", func(w http.ResponseWriter, r *http.Request) {
    // 精确注册覆盖子树根的默认尾斜杠跳转
    fmt.Fprintln(w, "docs index")
})
mux.HandleFunc("/docs/", func(w http.ResponseWriter, r *http.Request) {
    // 其他 docs 子路径仍由子树处理
    fmt.Fprintln(w, "docs subtree")
})

排查时顺手检查路径清理和客户端行为

ServeMux 还会把点段、重复斜杠等非规范路径重定向到清理后的地址；这与“子树根补尾斜杠”是两类原因。若日志只记录最终 handler，很容易把两种跳转混在一起。建议在测试表中同时记录原始路径、状态码、Location 和最终 handler。

另外，模式还可以带 HTTP 方法或主机名。加入这些条件后，先确认请求方法、Host 是否满足，再判断尾斜杠；不要用一个只覆盖 GET 的注册项去解释 POST 的结果。

常见问题

为什么访问 /docs 没有进入 /docs/ handler？

因为 /docs/ 表示子树，/docs 是它的根但不是同一个规范路径；ServeMux 默认先重定向。

怎样确认是不是 ServeMux 自己重定向？

用 httptest.NewRecorder 读取第一跳的状态码和 Location，不要只观察浏览器最终页面。

注册 /docs 会不会影响 /docs/guide？

不会。/docs 负责精确路径，/docs/ 仍可接收它覆盖的子路径。

记住一个判断顺序：先看模式是精确路径还是子树，再看请求是否规范化，最后才检查客户端是否自动跟随了重定向。