Go语言将自定义ServeMux挂载到http.Handle指定路径后子路由返回404的问题

两个原因叠加导致了404，都是Go标准库http.ServeMux的匹配规则导致的：

• 主程序注册路由时写的是不带尾斜杠的/path。根据ServeMux的规则，非根路径的注册项如果没有尾斜杠，只会精确匹配路径完全等于/path的请求，所有以/path/开头的子路径（比如访问的/path/one）都不会被命中，直接返回404。
• 就算你把主程序的注册路径改成带尾斜杠的/path/，让所有/path/开头的请求都能转发到自定义Handler，ServeMux不会自动帮你剥离已匹配的路径前缀：你的内部Handler收到的请求URL.Path依然是完整的/path/one，和内部mux注册的/one、/two路由完全匹配不上，还是会返回404。

按照你设计的「Handler可挂载到任意路径」的需求，修改两处即可解决：

1. 主程序注册路由时，路径加上尾斜杠/path/，确保所有该前缀下的子路径都能被主mux转发到自定义Handler。
2. 用标准库提供的http.StripPrefix对内部Handler做一层包装，在请求进入内部mux前剥掉挂载的路径前缀，让内部mux收到的路径和自身注册的路由完全匹配。

修改后的主程序代码如下：

package main

import (
    "net/http"

    "github.com/someuser/someproject"
)

func main() {
    http.Handle("/path/", 
        http.StripPrefix("/path", someproject.NewHandler()),
    )
    http.ListenAndServe(":8080", nil)
}

修改后访问http://localhost:8080/path/one时：

• 主mux匹配到/path/注册项，将请求转发给包装后的Handler
• StripPrefix会把请求路径从/path/one修改为/one
• 内部mux收到/one路径的请求，命中对应handler返回"one"
• 同样/path/two也能正常返回"two"

这种写法不依赖固定的挂载路径，你后续不管把Handler挂到/api/v2/xxx还是其他任意前缀下，只要配合对应路径的StripPrefix处理，都能正常工作。

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