Go路由中间件通过func(http.https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705)http.https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705函数链式组合，支持顺序可控的嵌套包装、context共享数据及切片动态配置。
在 Go 中实现路由中间件组合，核心是利用函数式编程思想，通过闭包和函数链式调用，在请求进入业务处理器前/后插入可复用、可叠加的处理逻辑。关键不在于“写多少中间件”，而在于让它们能自由组合、顺序可控、上下文共享。
中间件的本质：接收 https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705，返回新 https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705
Go 的 http.https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705 接口只有一个 ServeHTTP 方法。中间件就是“包装”这个接口的函数：
- 输入：原始 https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705（如业务路由函数）
- 输出：一个新 https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705，它内部先执行中间件逻辑（如日志、鉴权），再调用原 https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705
- 多个中间件可嵌套调用，形成处理链
标准写法：函数签名统一，支持链式拼接
推荐使用 func(http.https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705) http.https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705 类型，便于组合：
// 日志中间件
func Logger(next http.https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705) http.https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705 {
return http.https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705Func(func(w http.ResponseWriter, r *http.Request) {
log.Printf("→ %s %s", r.Method, r.URL.Path)
next.ServeHTTP(w, r)
log.Printf("← %s %s done", r.Method, r.URL.Path)
})
}
// JWT 鉴权中间件
func AuthJWT(secret string) func(http.https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705) http.https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705 {
return func(next http.https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705) http.https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705 {
return http.https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705Func(func(w http.ResponseWriter, r *http.Request) {
tokenStr := r.Header.Get("Authorization")
if !isValidToken(tokenStr, secret) {
http.Error(w, "Unauthorized", http.StatusUnauthorized)
return
}
next.ServeHTTP(w, r)
})
}
}
使用时可逐层包裹：
立即学习“go语言免费学习笔记（深入）”；
https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705 := http.https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705Func(userhttps://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705)
https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705 = Logger(https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705)
https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705 = AuthJWT("my-secret")(https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705)
http.Handle("/api/user", https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705)更灵活：用切片+循环实现中间件栈
当需要动态加载或配置中间件顺序时，把中间件定义为切片，统一应用：
type Middleware func(http.https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705) http.https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705func Chain(https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705 http.https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705, mws ...Middleware) http.https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705 { for i := len(mws) - 1; i >= 0; i-- { https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705 = mwsi } return https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705 }
// 使用 mws := []Middleware{ Recovery, Logger, AuthJWT("my-secret"), RateLimit(100), } final := Chain(http.https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705Func(userhttps://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705), mws...)
注意倒序遍历：保证最外层中间件最先执行（如日志记录整个链耗时），最内层最后执行（如业务逻辑）。
共享上下文：用 context.WithValue 传递数据
中间件之间需传递信息（如用户 ID、请求 ID），不要用全局变量。推荐在 Request.Context() 中存取：
type ctxKey string const UserIDKey ctxKey = "user_id"func AuthJWT(secret string) Middleware { return func(next http.https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705) http.https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705 { return http.https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705Func(func(w http.ResponseWriter, r *http.Request) { uid := parseUserIDFromToken(r.Header.Get("Authorization"), secret) ctx := context.WithValue(r.Context(), UserIDKey, uid) r = r.WithContext(ctx) // 创建新 request next.ServeHTTP(w, r) }) } }
// 在业务 https://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705 中读取 func userhttps://www.php.cn/link/d0ab3eaa2d0af7efe82a485a26fb2705(w http.ResponseWriter, r *http.Request) { uid := r.Context().Value(UserIDKey).(string) fmt.Fprintf(w, "Hello, user %s", uid) }
避免 key 冲突：用未导出的自定义类型（如 ctxKey）做 map key，比字符串更安全。
不复杂但容易忽略：中间件顺序决定执行流，context 传递要显式赋值新 request，组合函数要保持签名一致。做好这三点，就能稳健扩展路由处理能力。
