gin入门教程(6):全局中间件,自定义中间件

在 Gin 中,中间件用于处理请求的预处理和后处理,可以实现日志、身份验证、跨域资源共享(CORS)等功能。下面是如何使用和创建中间件的基本步骤:

1. 使用内置中间件

Gin 提供了一些内置中间件,例如:

  • 日志中间件:
go 复制代码
r.Use(gin.Logger())
  • 恢复中间件(处理恐慌并恢复):
go 复制代码
r.Use(gin.Recovery())
2. 自定义中间件

您可以轻松创建自定义中间件,例如简单的身份验证:

go 复制代码
func AuthMiddleware() gin.HandlerFunc {
    return func(c *gin.Context) {
        token := c.GetHeader("Authorization")
        if token != "your_secret_token" {
            c.JSON(401, gin.H{"error": "Unauthorized"})
            c.Abort() // 中止后续处理
            return
        }
        c.Next() // 继续处理请求
    }
}
3. 注册中间件

您可以在路由组中注册中间件,或在全局范围内使用:

  • 全局中间件:
go 复制代码
r.Use(AuthMiddleware())
  • 路由组中间件:
go 复制代码
v1 := r.Group("/v1")
v1.Use(AuthMiddleware())
{
    v1.GET("/users", getUsers)
}
4. 中间件顺序

中间件的执行顺序是根据它们被注册的顺序,先注册的中间件先执行。在调用 c.Next() 后,后续的中间件会执行,最后返回响应。

示例

以下是一个使用中间件的完整示例:

go 复制代码
package main

import (
    "github.com/gin-gonic/gin"
)

func main() {
    r := gin.Default()
    
    // 注册日志和恢复中间件
    r.Use(gin.Logger())
    r.Use(gin.Recovery())
    
    // 注册自定义中间件
    r.Use(AuthMiddleware())

    r.GET("/ping", func(c *gin.Context) {
        c.JSON(200, gin.H{"message": "pong"})
    })

    r.Run(":8080")
}

func AuthMiddleware() gin.HandlerFunc {
    return func(c *gin.Context) {
        token := c.GetHeader("Authorization")
        if token != "your_secret_token" {
            c.JSON(401, gin.H{"error": "Unauthorized"})
            c.Abort()
            return
        }
        c.Next()
    }
}

总结

中间件是 Gin 中非常强大的特性,通过它可以在请求处理流程中插入额外的逻辑,以满足不同的需求。您可以根据实际情况自由组合使用。

相关推荐
里海_go2 天前
Go 语言内存管理机制详解
go
斐波那契数列2 天前
没有 JSX,也能在 Go 里写 React 风格 GUI:Tenon 的架构与性能实践
go
花椒技术2 天前
花椒语音房联机五子棋:Go 服务端如何保证一回合只落一颗子
websocket·go
利威尔xu2 天前
2026-11-18-Go接口幂等设计实战
开发语言·后端·golang
Sailing2 天前
🚀客户端都超时了,你的 Go 服务还在查库?Context 取消链路不打通,连接池迟早被打爆
后端·面试·go
小满zs3 天前
Go语言第二十一章(Gin上传文件)
后端·go
我不会起名字3223 天前
Agent 总调错工具?MCP 接进 Go 后端的 4 个约束
后端·go·agent·mcp
利威尔xu3 天前
Go Mutex 饥饿模式:正常模式等待者饿死,1ms 阈值自动切换崩溃
开发语言·后端·面试·golang·并发编程
利威尔xu4 天前
Go channel 关闭 3 个 panic:向已关闭 channel 发送,服务当场崩溃
开发语言·后端·golang·并发编程·channel
Java展博4 天前
[Go 后端转场] 从 try-catch 到 if err != nil:写惯 Java 的人第一次上手最别扭的 4 件事
java·开发语言·golang