Golang http.HandleFunc注册路由部分不生效跳转首页问题求助

问题根因 #

Go 标准库 net/http 内置的默认路由 ServeMux 采用最长前缀匹配规则，同时对带/不带末尾斜杠的路径有特殊的重定向逻辑：

• 你注册的是不带末尾斜杠的路由 /contact，只有请求路径完全等于 /contact 时才会精确匹配
• 如果请求路径是 /contact/（末尾带斜杠），没有对应精确路由的情况下，会匹配最长的公共前缀路由 /，直接走首页 handler
• 你遇到的跳转首页问题大概率是浏览器缓存了历史301重定向规则，访问 /contact 时自动补了斜杠变成 /contact/，最终匹配到根路由
• /project 改 /projects 无法生效也是同样的逻辑：要么是浏览器缓存了旧的重定向规则，要么是存在未注册的带斜杠路由匹配冲突。

解决方案 #

1. 同时注册带/不带斜杠的路由
   适合需要两种路径都能正常访问的场景：

func main() {
    http.HandleFunc("/", home)
    http.HandleFunc("/project", project)
    http.HandleFunc("/project/", project)
    http.HandleFunc("/about", about)
    http.HandleFunc("/about/", about)
    http.HandleFunc("/contact", contact)
    http.HandleFunc("/contact/", contact)

    http.Handle("/resources/", http.StripPrefix("/resources", http.FileServer(http.Dir("./assets"))))

    err := http.ListenAndServe(":80", nil)
    if err != nil {
        fmt.Println("ListendAndServe doesn't work : ", err)
    }
}

2. 统一注册带末尾斜杠的路由
   利用 ServeMux 的自动重定向能力，用户访问不带斜杠的路径时会自动301跳转到带斜杠的路径：

http.HandleFunc("/contact/", contact)
http.HandleFunc("/projects/", projects)

3. 排查缓存干扰
   用curl命令直接发起请求，排除浏览器缓存影响，确认实际返回结果：

curl -v http://localhost/contact

如果需要更灵活的路由规则（比如忽略末尾斜杠、参数路由等），可以直接使用 gin、gorilla/mux 等第三方路由库，不需要自己处理内置路由的边界问题。

内容的提问来源于stack exchange，提问作者Job van Esch