Go net/http 路由基础
在go语言中，net/http包提供了构建http服务器的强大功能。其中，http.handlefunc函数是核心之一，它用于将特定的url路径与一个处理函数（http.handlerfunc）关联起来。当http请求到达服务器时，http.servemux（go默认的http请求复用器）会根据请求的url路径，查找并调用相应的处理函数。
package hello
import (
"fmt"
"net/http"
)
func init() {
// 注册路由处理器
http.HandleFunc("/service", serviceHandler)
http.HandleFunc("/site", siteHandler)
http.HandleFunc("/", handler) // 默认处理器
}
func handler(w http.ResponseWriter, r *http.Request) {
fmt.Fprint(w, "Hello, there")
}
func serviceHandler(w http.ResponseWriter, r *http.Request) {
fmt.Fprint(w, "this is Services")
}
func siteHandler(w http.ResponseWriter, r *http.Request) {
fmt.Fprint(w, "this is Sites")
}上述代码展示了一个典型的路由注册示例，其中定义了三个路径及其对应的处理函数。然而，初学者常会在此处遇到一个问题：当访问http://myserver/service/foo时，期望serviceHandler被调用，但实际执行的却是handler函数，输出“Hello, there”。这背后的原因在于net/http的路径匹配机制。
路径匹配机制详解
net/http的默认路由器http.ServeMux在匹配请求路径时，遵循一套明确的规则，这套规则主要区分两种匹配模式：
精确匹配 (Exact Match): 当注册的路径不带尾部斜杠时（例如/service），它只匹配与该路径完全相同的请求。这意味着，http.HandleFunc("/service", serviceHandler)只会处理对/service的请求，而不会处理/service/foo或/service/bar等子路径的请求。
前缀匹配 (Prefix Match): 当注册的路径带尾部斜杠时（例如/service/），它会匹配所有以该路径为前缀的请求。例如，http.HandleFunc("/service/", serviceHandler)会处理/service/、/service/foo、/service/bar/baz等所有以/service/开头的请求。
默认处理器 (Catch-all Handler): 路径/是一个特殊的处理器。它作为所有未被其他更具体规则匹配的请求的“兜底”处理器。如果一个请求的URL路径无法被任何其他已注册的精确匹配或前缀匹配规则捕获，它最终将由/对应的处理器来处理。
匹配优先级：http.ServeMux在查找匹配项时，会优先尝试最精确的匹配。它会先查找与请求路径完全匹配的规则（精确匹配），如果没有找到，则会查找最长的、以请求路径为前缀的规则（前缀匹配）。如果仍然没有找到，最终会回退到/处理器。
案例分析：常见的路由误解
回到最初的问题代码：
func init() {
http.HandleFunc("/service", serviceHandler) // 精确匹配
http.HandleFunc("/site", siteHandler) // 精确匹配
http.HandleFunc("/", handler) // 默认处理器
}当收到http://myserver/service/foo的请求时：
- 路由器首先查找与/service/foo精确匹配的规则，没有找到。
- 接着，它查找最长的、以/service/foo为前缀的规则。
- /service不是/service/foo的前缀，因为它不带尾部斜杠，只匹配/service。
- /site也不是。
- 最终，没有其他规则能匹配/service/foo。
- 因此，请求被/这个默认处理器捕获，handler()函数被执行，输出“Hello, there”。
这正是导致serviceHandler()和siteHandler()被“忽略”的原因，它们只对精确路径有效，而无法处理其子路径。
解决方案：正确使用带斜杠的路径
要解决这个问题，并让serviceHandler能够处理/service/foo这样的子路径，只需在注册路径时添加一个尾部斜杠，将其变为前缀匹配模式：
package hello
import (
"fmt"
"net/http"
)
func init() {
// 修正后的路由注册：使用带尾部斜杠的路径实现前缀匹配
http.HandleFunc("/service/", serviceHandler) // 现在会匹配 /service/, /service/foo, /service/bar 等
http.HandleFunc("/site/", siteHandler) // 现在会匹配 /site/, /site/foo, /site/bar 等
http.HandleFunc("/", handler) // 默认处理器，用于处理所有其他未匹配的请求
}
func handler(w http.ResponseWriter, r *http.Request) {
fmt.Fprint(w, "Hello, there")
}
func serviceHandler(w http.ResponseWriter, r *http.Request) {
fmt.Fprint(w, "this is Services")
}
func siteHandler(w http.ResponseWriter, r *http.Request) {
fmt.Fprint(w, "this is Sites")
}通过将/service改为/service/，当请求http://myserver/service/foo到达时：
- 路由器查找与/service/foo精确匹配的规则，没有找到。
- 接着，它查找最长的、以/service/foo为前缀的规则。此时，/service/规则被发现，它匹配/service/foo。
- serviceHandler()函数被调用，输出“this is Services”，符合预期。
注意事项与最佳实践
- 明确区分精确匹配与前缀匹配： 在设计路由时，首先要明确你的路径是需要精确匹配某个URL，还是需要匹配一个URL及其所有子路径。这决定了你是否应该在路径末尾添加斜杠。
- 善用/默认处理器： /处理器是强大的“兜底”机制，但要警惕它可能意外捕获你本打算由其他更具体处理器处理的请求。合理安排路由顺序和匹配模式，确保请求能被最合适的处理器捕获。
- 路由顺序不影响匹配逻辑： 对于http.ServeMux，HandleFunc的注册顺序通常不影响其匹配逻辑。它总是会尝试找到最精确的匹配。
- 复杂路由场景： 对于需要更复杂路由功能（如路径参数、HTTP方法匹配、中间件链等）的应用，标准库的http.ServeMux可能显得力不从心。此时，可以考虑使用第三方路由库，例如gorilla/mux、chi等，它们提供了更灵活、更强大的路由功能。然而，对于大多数简单到中等规模的应用，net/http标准库已足够胜任。
总结
理解Go net/http中路径匹配的精确性是构建健壮Web应用的关键。核心要点在于：不带尾部斜杠的路径（如/path）执行精确匹配，只匹配该路径本身；而带尾部斜杠的路径（如/path/）执行前缀匹配，匹配所有以该路径为前缀的请求。 掌握这一规则，可以有效避免路由逻辑错误，确保HTTP请求能够被正确地分发到预期的处理函数。
