Go语言通过net/http包实现多路复用HTTP服务，使用ServeMux路由请求。1. 可用http.NewServeMux创建自定义路由器，按路径分发至不同处理器；2. 通过检查r.Host字段实现基于域名的路由，结合map映射主机名到对应处理器；3. 利用函数包装添加中间件，如日志、认证；4. 通过路径前缀模拟路由分组，实现模块化管理。标准库已足够应对多数场景，无需依赖框架。
在Go语言中构建多路复用HTTP服务并不复杂，标准库net/http已经内置了基础的路由能力。但要实现更灵活、高效的多路复用（即一个服务处理多个路径或主机名），需要理解其底层机制并合理组织代码结构。
理解HTTP多路复用的基本原理
多路复用指的是一个HTTP服务器能够根据请求的路径（path）或主机名（Host）将请求分发到不同的处理器。Go的http.ServeMux就是为此设计的，它是一个HTTP请求路由器。
当你调用http.HandleFunc("/api", handler)时，实际上是在默认的http.DefaultServeMux上注册了一个路由规则。服务器监听请求后，会根据URL路径匹配对应的处理器函数。
关键点在于：同一个端口可以响应不同路径或域名的请求，只要路由配置得当。
立即学习“go语言免费学习笔记（深入）”；
使用自定义ServeMux提升灵活性
虽然默认的多路复用器可用，但建议创建独立的ServeMux实例，避免包级变量带来的副作用，也便于测试和模块化管理。
package main
import (
"net/http"
)
func main() {
mux := http.NewServeMux()
mux.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
w.Write([]byte("首页"))
})
mux.HandleFunc("/api/users", func(w http.ResponseWriter, r *http.Request) {
w.Write([]byte(`{"users": []}`))
})
http.ListenAndServe(":8080", mux)
}
这种方式让路由逻辑集中且清晰，适合中小型项目。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
基于主机名的多路复用实现
如果想让同一个端口响应不同域名（如api.example.com和www.example.com），可以通过检查r.Host字段手动分发，或使用第三方库。但也可以用标准库实现简单分流。
方法是：注册一个顶层处理器，根据Host头决定调用哪个子处理器。
示例：
func virtualHostHandler(muxs map[string]http.Handler) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
if h, ok := muxs[r.Host]; ok {
h.ServeHTTP(w, r)
return
}
http.Error(w, "未知主机", 404)
}
}
// 使用方式
muxAPI := http.NewServeMux()
muxAPI.HandleFunc("/users", apiHandler)
muxWeb := http.NewServeMux()
muxWeb.HandleFunc("/", webHandler)
allMux := http.NewServeMux()
allMux.Handle("api.example.com", virtualHostHandler(map[string]http.Handler{
"api.example.com": muxAPI,
"www.example.com": muxWeb,
}))
中间件与路由分组技巧
实际开发中常需日志、认证等通用逻辑。可通过函数包装实现中间件模式。
例如添加日志中间件：
func logging(next http.HandlerFunc) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
println(r.Method, r.URL.Path)
next(w, r)
}
}
// 注册带中间件的路由
mux.HandleFunc("/admin", logging(adminHandler))
对于路由分组，虽无原生支持，但可通过路径前缀模拟：
-
/v1/users和/v1/orders归属 v1 API 组 - 统一加前缀，便于后续迁移或加中间件
基本上就这些。Go的标准库足够支撑大多数多路复用场景，无需一开始就引入Gin或Echo等框架。理清ServeMux、请求分发和中间件组合方式，就能写出清晰高效的HTTP服务。
