Go 1.22 net/http分组路由问题：/v1/user端点异常求助

你的问题核心在于net/http ServeMux的路由匹配规则和嵌套路由时的StripPrefix配置不匹配，导致/v1/user（不带尾斜杠）触发错误的自动重定向，同时路由逻辑不符合预期。

问题原因拆解 #

1. 自动重定向触发：当你在v1.Handle("/user/", ...)注册带尾斜杠的路径时，ServeMux会将其识别为"目录"路径。当请求/v1/user（不带尾斜杠）时，ServeMux会自动返回301重定向，但由于StripPrefix的截断，重定向地址出现错误。
2. StripPrefix与路由路径不匹配：嵌套路由时，StripPrefix的参数必须和Handle的路径前缀完全对应，否则会导致路径截断逻辑混乱，引发404或路由匹配错误。

修正后的代码 #

// userRouter 处理/user相关的子路由（后续可移至user.go）
userRouter := http.NewServeMux()
// 匹配 /v1/user 和 /v1/user/
userRouter.HandleFunc("GET /", func(w http.ResponseWriter, r *http.Request) {
    w.Write([]byte("GET /v1/user"))
})
// 匹配 /v1/user/{username}
userRouter.HandleFunc("GET /{username}", func(w http.ResponseWriter, r *http.Request) {
    w.Write([]byte("GET /v1/user/{username}"))
})

// v1路由组（保留在api.go）
v1 := http.NewServeMux()
// 同时注册带/不带尾斜杠的路径，配合对应StripPrefix确保路径截断正确
v1.Handle("/user", http.StripPrefix("/user", userRouter))
v1.Handle("/user/", http.StripPrefix("/user/", userRouter))

// 主路由
main := http.NewServeMux()
main.Handle("/v1", http.StripPrefix("/v1", v1))
main.Handle("/v1/", http.StripPrefix("/v1/", v1))

server := &http.Server{Addr: "localhost:5000", Handler: main}
server.ListenAndServe()

关键调整说明 #

1. 覆盖带/不带尾斜杠的请求：同时注册两种路径形式，避免ServeMux触发自动重定向，确保/v1/user和/v1/user/都能被正确处理。
2. StripPrefix参数与路由前缀严格对应：
   • 当注册/user路径时，用StripPrefix("/user")截断前缀，确保/v1/user/john被处理为/john传给userRouter。
   • 当注册/user/路径时，用StripPrefix("/user/")截断，同样保证子路由能正确匹配/{username}。
3. 保持子路由独立性：userRouter内部仍使用简洁的根路径/和参数路径/{username}，后续拆分到单独文件时无需修改路径逻辑。

测试验证 #

修改后重新运行服务，curl测试结果符合预期：

$ curl -X 'GET' 'http://localhost:5000/v1/user/john'      
GET /v1/user/{username}

$ curl -X 'GET' 'http://localhost:5000/v1/user/'
GET /v1/user

$ curl -X 'GET' 'http://localhost:5000/v1/user'
GET /v1/user

额外优化建议 #

如果觉得重复注册路径繁琐，可以写一个辅助函数简化操作：

func handleWithSlash(mux *http.ServeMux, path string, handler http.Handler) {
    mux.Handle(path, handler)
    mux.Handle(path+"/", handler)
}

// 使用示例
handleWithSlash(v1, "/user", http.StripPrefix("/user", userRouter))
handleWithSlash(main, "/v1", http.StripPrefix("/v1", v1))

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