如何让嵌套http.ServeMux处理无尾斜杠路径且不重定向？

问题背景 #

使用嵌套http.ServeMux处理请求时，访问localhost:8080/top_path（无尾斜杠）虽能得到预期的sub mux响应，但会被自动重定向到带尾斜杠的localhost:8080/top_path/。我们需要实现：既能处理无尾斜杠的top_path请求且不触发重定向，同时正常响应/top_path/sub_path这类子路径请求。

原示例代码：

package main

import (
    "net/http"
)

func main() {
    rootMux := http.NewServeMux()
    rootMux.Handle("/", writeHandler("root mux"))
    rootMux.Handle("/top_path/", http.StripPrefix("/top_path", subHandler()))

    http.ListenAndServe(":8080", rootMux)
}

func subHandler() http.Handler {
    subMux := http.NewServeMux()
    subMux.Handle("/", writeHandler("sub mux"))
    subMux.Handle("/sub_path", writeHandler("sub path"))
    return subMux
}

func writeHandler(message string) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        w.Write([]byte(message))
    })
}

解决方案 #

方法一：同时注册带斜杠与不带斜杠的路径 #

在根Mux中同时注册/top_path和/top_path/两个路径，指向同一处理逻辑，让无尾斜杠请求直接被处理，避免重定向：

func main() {
    rootMux := http.NewServeMux()
    rootMux.Handle("/", writeHandler("root mux"))
    
    // 复用子Mux实例，分别注册两种路径
    subHandler := subHandler()
    rootMux.Handle("/top_path", http.StripPrefix("/top_path", subHandler))
    rootMux.Handle("/top_path/", http.StripPrefix("/top_path/", subHandler))

    http.ListenAndServe(":8080", rootMux)
}

注意对应调整StripPrefix的参数，确保子Mux收到的路径格式正确（比如/top_path/sub_path会被处理为/sub_path传给子Mux）。

方法二：自定义Handler统一处理路径 #

写一个封装Handler，自动适配无尾斜杠和子路径请求，无需重复注册路径：

import "strings"

func noRedirectSubHandler() http.Handler {
    subMux := subHandler()
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        switch {
        case r.URL.Path == "/top_path":
            // 无尾斜杠请求重写为子Mux的根路径
            r.URL.Path = "/"
        case strings.HasPrefix(r.URL.Path, "/top_path/"):
            // 子路径请求去除前缀
            r.URL.Path = strings.TrimPrefix(r.URL.Path, "/top_path")
        }
        subMux.ServeHTTP(w, r)
    })
}

// 在main中注册
func main() {
    rootMux := http.NewServeMux()
    rootMux.Handle("/", writeHandler("root mux"))
    rootMux.Handle("/top_path", noRedirectSubHandler())
    rootMux.Handle("/top_path/", noRedirectSubHandler())

    http.ListenAndServe(":8080", rootMux)
}

方法三：拆分根路径与子路径处理 #

直接在根Mux中处理无尾斜杠的/top_path请求，带斜杠的路径交给子Mux处理子路径，适合子Mux根逻辑简单的场景：

func main() {
    rootMux := http.NewServeMux()
    rootMux.Handle("/", writeHandler("root mux"))
    
    // 直接处理无尾斜杠请求
    rootMux.HandleFunc("/top_path", func(w http.ResponseWriter, r *http.Request) {
        w.Write([]byte("sub mux"))
    })
    // 带斜杠路径交给子Mux处理子路径
    rootMux.Handle("/top_path/", http.StripPrefix("/top_path", subHandler()))

    http.ListenAndServe(":8080", rootMux)
}

原理说明 #

http.ServeMux的尾斜杠重定向逻辑是：当请求路径无尾斜杠，但存在带尾斜杠的注册路径时，会触发重定向。只要直接注册无尾斜杠的路径，Mux就会直接处理该请求，不会触发重定向。

内容的提问来源于stack exchange，提问作者Sam Herrmann