Go语言中HTTP中间件通过包装http.Handler实现通用逻辑复用，典型应用包括日志、认证、CORS等；中间件以函数形式接收并返回Handler，支持前置后置操作；常用实现有Logging、Auth、CORS中间件；多个中间件可手动嵌套或使用alice库组合，执行顺序从外到内；需注意Header写入时机与OPTIONS预检处理。
在Go语言中开发HTTP中间件，是构建可维护、可扩展Web服务的关键手段。中间件可以处理日志记录、身份验证、请求限流、跨域支持等通用逻辑，避免在每个处理器中重复编写。下面介绍如何设计和使用Golang的HTTP中间件，并提供实用示例。
中间件的基本原理
Go的http.Handler接口是中间件设计的核心。一个中间件本质上是一个函数，接收http.Handler并返回一个新的http.Handler，在这个过程中可以插入前置或后置操作。
常见中间件结构如下：
func Middleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
// 前置处理：如日志、认证
log.Println("Request received:", r.URL.Path)
// 调用下一个处理器
next.ServeHTTP(w, r)
// 后置处理：如记录响应时间
log.Println("Request completed")
})
}
常用中间件实现示例
以下是几个典型中间件的实现方式，便于直接集成到项目中。
立即学习“go语言免费学习笔记（深入）”；
1. 日志中间件记录每次请求的路径、方法和耗时。
func LoggingMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
start := time.Now()
log.Printf("Started %s %s", r.Method, r.URL.Path)
next.ServeHTTP(w, r)
log.Printf("Completed %s in %v", r.URL.Path, time.Since(start))
})
}
2. 身份验证中间件
检查请求头中的Token是否有效。
PHP Apache和MySQL 网页开发初步
下载
本书全面介绍PHP脚本语言和MySOL数据库这两种目前最流行的开源软件，主要包括PHP和MySQL基本概念、PHP扩展与应用库、日期和时间功能、PHP数据对象扩展、PHP的mysqli扩展、MySQL 5的存储例程、解发器和视图等。本书帮助读者学习PHP编程语言和MySQL数据库服务器的最佳实践，了解如何创建数据库驱动的动态Web应用程序。
func AuthMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
token := r.Header.Get("Authorization")
if token != "Bearer my-secret-token" {
http.Error(w, "Unauthorized", http.StatusUnauthorized)
return
}
next.ServeHTTP(w, r)
})
}
3. 跨域支持（CORS）中间件
允许前端应用从不同域名访问API。
func CORSMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Access-Control-Allow-Origin", "*")
w.Header().Set("Access-Control-Allow-Methods", "GET, POST, PUT, DELETE, OPTIONS")
w.Header().Set("Access-Control-Allow-Headers", "Content-Type, Authorization")
if r.Method == "OPTIONS" {
w.WriteHeader(http.StatusOK)
return
}
next.ServeHTTP(w, r)
})
}
组合多个中间件
实际项目中通常需要叠加多个中间件。可以通过手动嵌套或使用第三方库（如alice）简化流程。
手动组合示例：
handler := http.HandlerFunc(YourHandler)
stacked := LoggingMiddleware(AuthMiddleware(CORSMiddleware(handler)))
http.Handle("/api/data", stacked)
这种写法从内到外依次包裹，执行顺序为：CORS → Auth → Logging → Handler。
使用alice可让代码更清晰：
import "github.com/justinas/alice"
chain := alice.New(LoggingMiddleware, CORSMiddleware, AuthMiddleware)
http.Handle("/api/data", chain.Then(http.HandlerFunc(YourHandler)))
基本上就这些。掌握中间件模式后，能大幅提升Go Web服务的模块化程度和代码复用性。不复杂但容易忽略的是执行顺序和Header写入时机，需特别注意OPTIONS预检和错误响应的处理。
