Golang HTTP中间件开发与应用示例-Golang-PHP中文网

Golang HTTP中间件开发与应用示例

P粉602998670

发布： 2025-10-12 10:09:02

原创

921人浏览过

Go语言中HTTP中间件通过包装http.Handler实现通用逻辑复用，典型应用包括日志、认证、CORS等；中间件以函数形式接收并返回Handler，支持前置后置操作；常用实现有Logging、Auth、CORS中间件；多个中间件可手动嵌套或使用alice库组合，执行顺序从外到内；需注意Header写入时机与OPTIONS预检处理。

golang http中间件开发与应用示例

在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是否有效。

AppMall应用商店

AI应用商店，提供即时交付、按需付费的人工智能应用服务

查看详情

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预检和错误响应的处理。

以上就是Golang HTTP中间件开发与应用示例的详细内容，更多请关注php中文网其它相关文章！