本文讲解如何在不使用 DefaultServeMux 的前提下，将带数据库依赖的自定义 Handler 与 http.ServeMux 灵活组合，支持 /api/ 类路径前缀匹配（如 /api/jim 被正确路由到 /api/ 处理器），兼顾结构清晰性与 HTTP 路由语义。
本文讲解如何在不使用 defaultservemux 的前提下，将带数据库依赖的自定义 handler 与 http.servemux 灵活组合，支持 `/api/` 类路径前缀匹配（如 `/api/jim` 被正确路由到 `/api/` 处理器），兼顾结构清晰性与 http 路由语义。
Go 标准库中的 http.ServeMux 不仅是一个路由表，它本身就是一个满足 http.Handler 接口的类型——这意味着它可以被任意嵌入、组合或挂载到其他 Handler 中，无需侵入式重构。你当前的 Handler 结构体（含 *DB 字段）本质是自定义的 http.Handler，而 ServeMux 同样是 http.Handler，二者天然可组合。关键在于：用 ServeMux 承担路径匹配职责，再将匹配后的请求委托给你的结构化 Handler 实例，从而复用其状态（如 DB 连接）和业务逻辑。
✅ 正确组合方式：将 ServeMux 作为主路由，委托子路径给结构化 Handler
你无需修改 Handler 的 ServeHTTP 方法来手动做字符串前缀判断（易出错且违背 HTTP 路由语义）。相反，应让 ServeMux 负责 /api/ 这类前缀匹配，再通过 http.StripPrefix 清理路径后交由 Handler 处理：
package main
import (
"database/sql"
"fmt"
"log"
"net/http"
_ "github.com/lib/pq" // 示例 PostgreSQL 驱动
)
type Handler struct {
DB *sql.DB
}
// ServeHTTP 现在只处理已精确匹配的子路径（如 "/" 或 "/jim"），不再负责前缀判断
func (h *Handler) ServeHTTP(w http.ResponseWriter, r *http.Request) {
switch r.URL.Path {
case "/":
h.serveRoot(w, r)
default:
// 捕获 /api/jim、/api/users 等 —— 因为 ServeMux 已确保 r.URL.Path 是相对路径（如 "/jim"）
h.handleAPI(w, r)
}
}
func (h *Handler) serveRoot(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(http.StatusOK)
w.Write([]byte("Welcome to root"))
}
func (h *Handler) handleAPI(w http.ResponseWriter, r *http.Request) {
// 此时 r.URL.Path 是 StripPrefix 后的结果，例如 "/jim" 或 "/users/123"
switch r.URL.Path {
case "/jim":
fmt.Fprintf(w, "Hello, Jim! DB connected: %v", h.DB != nil)
case "/users":
// 可进一步解析 query 或 body，调用 h.DB 查询
w.WriteHeader(http.StatusOK)
w.Write([]byte("User list"))
default:
http.Error(w, "API endpoint not found", http.StatusNotFound)
}
}
func main() {
dbinfo := "user=... dbname=... sslmode=disable"
db, err := sql.Open("postgres", dbinfo)
if err != nil {
log.Fatal("Failed to open DB:", err)
}
defer db.Close()
// 创建专用 API 路由器（ServeMux）
apiMux := http.NewServeMux()
// 将整个 apiMux 挂载到 "/api/" 路径，并自动剥离 "/api" 前缀
apiMux.Handle("/", http.StripPrefix("/api", &Handler{DB: db}))
// 主路由 mux
mux := http.NewServeMux()
mux.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(http.StatusOK)
w.Write([]byte("Main handler"))
})
// 关键：将 apiMux 作为子处理器挂载到 "/api/"
mux.Handle("/api/", apiMux)
server := &http.Server{
Addr: ":8888",
Handler: mux,
}
log.Println("Server starting on :8888")
log.Fatal(server.ListenAndServe())
}
? 核心要点说明
- http.StripPrefix("/api", handler)：当请求为 /api/jim 时，StripPrefix 会将 r.URL.Path 改写为 /jim，再交给 handler.ServeHTTP；这样你的 Handler 就能专注业务逻辑，无需手动切分路径。
- ServeMux.Handle("/api/", ...) 中的尾部 / 至关重要：它启用前缀匹配模式（即 /api/xxx、/api/、/api 均匹配），这是标准库对“目录式路由”的原生支持。
- 结构体实例直接作为 Handler：&Handler{DB: db} 满足 http.Handler 接口，可直接传入 Handle，完美保留 DB 引用。
- 零外部依赖：全程使用 net/http 标准库，无第三方框架耦合，适合轻量服务或需强控制权的场景。
⚠️ 注意事项
- 不要将 Handler 的 ServeHTTP 方法设计为“兜底匹配”（如 case "/api/" 后手动解析剩余路径），这会重复实现 ServeMux 已高效完成的工作，且易忽略 r.URL.RawPath、查询参数、重定向等边界情况。
- 若需更复杂的路由（如 RESTful 动态参数 /users/{id}），建议在 handleAPI 内部引入轻量解析器（如 strings.Split(r.URL.Path, "/")），或升级为 gorilla/mux、chi 等成熟路由器——它们同样兼容 http.Handler 组合范式。
- defer db.Close() 在 main 中执行是错误的：它会在 ListenAndServe 启动前就关闭连接。应确保 DB 生命周期覆盖整个服务运行期，通常在程序退出时（如监听 os.Interrupt）优雅关闭。
通过这种组合模式，你既保留了结构化 Handler 对状态（DB）的封装优势，又获得了 ServeMux 的健壮路径匹配能力，真正实现关注点分离与可维护性提升。
