在Golang的后端开发中，处理HTTP请求并管理路由是构建Web服务的基础工作，标准库net/http提供了完整的支持能力，不需要依赖第三方框架就能实现大部分场景的需求。
HTTP处理基础：Handler接口
Golang中所有的HTTP请求处理逻辑都围绕Handler接口展开，该接口的定义非常简单，只要求实现一个ServeHTTP方法，方法签名如下：
type Handler interface {
ServeHTTP(w ResponseWriter, r *Request)
}
其中ResponseWriter用于向客户端返回响应内容，*Request则包含了当前请求的所有信息，比如请求方法、请求路径、请求参数等。我们可以自定义结构体实现这个接口，也可以直接使用函数类型HandlerFunc，它已经帮我们实现了ServeHTTP方法，使用起来更加便捷。
下面是一个最简单的HTTP服务示例，处理根路径的GET请求：
package main
import (
"fmt"
"net/http"
)
// 定义处理函数
func helloHandler(w http.ResponseWriter, r *http.Request) {
// 只处理GET请求
if r.Method != http.MethodGet {
// 返回方法不允许的状态码
w.WriteHeader(http.StatusMethodNotAllowed)
fmt.Fprintf(w, "只支持GET请求")
return
}
// 返回响应内容
fmt.Fprintf(w, "Hello, Golang HTTP!")
}
func main() {
// 注册路由和处理函数
http.HandleFunc("/", helloHandler)
// 启动服务，监听8080端口
fmt.Println("服务启动在 :8080")
err := http.ListenAndServe(":8080", nil)
if err != nil {
fmt.Printf("服务启动失败: %vn", err)
}
}
使用默认Mux管理路由
上面的示例中用到的http.HandleFunc其实是使用了net/http包提供的默认多路复用器（DefaultServeMux），它会根据请求的路径匹配对应的处理函数。默认Mux的使用非常简单，只需要调用http.Handle或者http.HandleFunc注册路由即可，支持路径匹配规则：
- 精确匹配：比如
/user只会匹配路径为/user的请求 - 前缀匹配：比如
/static/会匹配所有以/static/开头的请求
下面是一个使用默认Mux管理多个路由的示例：
package main
import (
"fmt"
"net/http"
)
func homeHandler(w http.ResponseWriter, r *http.Request) {
fmt.Fprintf(w, "这是首页")
}
func userHandler(w http.ResponseWriter, r *http.Request) {
fmt.Fprintf(w, "这是用户页面")
}
func staticHandler(w http.ResponseWriter, r *http.Request) {
fmt.Fprintf(w, "这是静态资源路径")
}
func main() {
// 注册不同路径的处理函数
http.HandleFunc("/", homeHandler)
http.HandleFunc("/user", userHandler)
// 前缀匹配，所有/static/开头的请求都会走到这个处理函数
http.HandleFunc("/static/", staticHandler)
fmt.Println("服务启动在 :8080")
http.ListenAndServe(":8080", nil)
}
自定义Mux实现更灵活的路由管理
默认Mux虽然简单易用，但是在复杂场景下不够灵活，比如无法限制请求方法、无法提取路径参数。这时候我们可以自定义ServeMux实例，结合自定义Handler实现更丰富的路由规则。
首先我们可以定义一个结构体，包装ServeMux，同时添加方法限制的能力：
package main
import (
"fmt"
"net/http"
)
// 自定义路由结构体
type Router struct {
mux *http.ServeMux
}
// 创建新的路由实例
func NewRouter() *Router {
return &Router{
mux: http.NewServeMux(),
}
}
// 注册GET请求的处理函数
func (r *Router) Get(path string, handler http.HandlerFunc) {
r.mux.HandleFunc(path, func(w http.ResponseWriter, r *http.Request) {
if r.Method != http.MethodGet {
w.WriteHeader(http.StatusMethodNotAllowed)
fmt.Fprintf(w, "不支持的请求方法")
return
}
handler(w, r)
})
}
// 注册POST请求的处理函数
func (r *Router) Post(path string, handler http.HandlerFunc) {
r.mux.HandleFunc(path, func(w http.ResponseWriter, r *http.Request) {
if r.Method != http.MethodPost {
w.WriteHeader(http.StatusMethodNotAllowed)
fmt.Fprintf(w, "不支持的请求方法")
return
}
handler(w, r)
})
}
// 返回mux作为http.Handler
func (r *Router) Handler() http.Handler {
return r.mux
}
接下来使用自定义的Router来搭建服务，同时实现简单的路径参数提取：
package main
import (
"fmt"
"net/http"
"strings"
)
// 处理用户详情，提取路径中的用户ID
func userDetailHandler(w http.ResponseWriter, r *http.Request) {
// 提取路径参数，假设路径是 /user/123 这样的格式
path := r.URL.Path
// 去掉开头的/user/
id := strings.TrimPrefix(path, "/user/")
if id == "" || id == path {
w.WriteHeader(http.StatusBadRequest)
fmt.Fprintf(w, "用户ID不存在")
return
}
fmt.Fprintf(w, "用户ID是: %s", id)
}
func main() {
router := NewRouter()
// 注册GET请求的路由
router.Get("/", func(w http.ResponseWriter, r *http.Request) {
fmt.Fprintf(w, "首页")
})
router.Get("/user", func(w http.ResponseWriter, r *http.Request) {
fmt.Fprintf(w, "用户列表")
})
// 用户详情路由，支持路径参数
router.Get("/user/", userDetailHandler)
// 注册POST请求的路由
router.Post("/user", func(w http.ResponseWriter, r *http.Request) {
fmt.Fprintf(w, "创建用户成功")
})
fmt.Println("服务启动在 :8080")
http.ListenAndServe(":8080", router.Handler())
}
常见问题与注意事项
路由匹配优先级
ServeMux的路由匹配规则是优先匹配更具体的路径，比如同时注册了/user/和/user/profile，那么请求/user/profile的时候会匹配到/user/profile的处理函数，而不是前缀匹配的/user/。
处理404情况
如果没有匹配到任何路由，默认Mux会返回404页面，我们也可以自定义404处理逻辑，只需要在注册所有路由之后，添加一个能匹配所有路径的处理函数即可：
// 自定义404处理
func notFoundHandler(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(http.StatusNotFound)
fmt.Fprintf(w, "请求的页面不存在")
}
// 注册404处理，放在所有路由注册的最后
http.HandleFunc("/", notFoundHandler)
请求参数的获取
获取GET请求的参数可以使用r.URL.Query().Get("参数名")，获取POST表单参数可以使用r.ParseForm()之后调用r.Form.Get("参数名")，如果是JSON格式的请求体，则需要先读取r.Body再解析。
通过以上内容，我们可以掌握Golang中处理HTTP请求以及使用Handler和Mux管理路由的完整方法，无论是简单的demo还是中小型Web服务，都可以通过标准库的能力实现，不需要额外引入复杂的第三方框架。