遇到 Gin 中间件鉴权后上下文 User 信息为空，优先检查中间件注册顺序与 Context Key 名称是否一致。

快速处理思路

这不是 shell 命令问题，而是代码逻辑问题。先打开路由注册文件，查找中间件加载位置。

// 错误示例：中间件注册在路由之后，请求不会经过中间件
r.GET("/api/user", Handler)
r.Use(AuthMiddleware())

// 正确示例：中间件全局注册或组注册，确保请求先经过中间件
r.Use(AuthMiddleware())
r.GET("/api/user", Handler)

标准中间件代码模板

参考以下标准写法，确保 c.Next() 被正确调用以传递请求到下一个 handler。

func AuthMiddleware() gin.HandlerFunc {
    return func(c *gin.Context) {
        // 1. 解析 Token (省略具体解析逻辑)
        token := c.GetHeader("Authorization")
        if token == "" {
            c.JSON(401, gin.H{"error": "missing token"})
            c.Abort() // 终止后续处理
            return
        }

        // 2. 验证成功，设置上下文
        user := &models.User{ID: 1001, Name: "test"}
        c.Set("context_user_key", user)

        // 3. 关键：调用 Next 传递请求到业务 Handler
        // 如果不调用 c.Next()，请求将在此处结束，Handler 不会执行
        c.Next()

        // 4. (可选) 后置处理，如记录响应时间
    }
}

分步排查与修复

1. 检查中间件注册顺序
打开 main.go 或 router.go，确保 Auth 中间件在定义具体路由之前被添加到引擎或路由组中。

2. 核对 Context Key
搜索代码中 c.Set 和 c.Get 使用的字符串。建议定义常量统一管理，避免大小写错误或拼写不一致：

const ContextUserKey = "login_user"

// 中间件里
c.Set(ContextUserKey, user)

// Handler 里
val, exists := c.Get(ContextUserKey)

3. 安全调试日志
在中间件设置值之后，立即打印日志确认值已写入。注意：不要打印完整 Token 或用户敏感信息，仅打印 ID 或存在性标志。

// 中间件内日志示例
if exists {
    // 安全做法：仅打印 ID
    log.Printf("[Middleware] User set, ID: %d", user.ID)
    // 危险做法：避免打印 %+v 可能泄露密码或 Token
    // log.Printf("[Middleware] User: %+v", user) 
}

获取数据与类型断言

从 Context 获取数据后必须进行类型断言，否则无法使用用户信息。以下是安全获取示例：

func UserProfileHandler(c *gin.Context) {
    val, exists := c.Get(ContextUserKey)
    if !exists {
        c.JSON(500, gin.H{"error": "user info not found in context"})
        return
    }

    // 类型断言，确保类型匹配中间件设置的类型
    user, ok := val.(*models.User)
    if !ok {
        c.JSON(500, gin.H{"error": "invalid user type in context"})
        return
    }

    c.JSON(200, gin.H{"uid": user.ID, "name": user.Name})
}

怎么验证是否生效

启动服务后，使用 curl 携带合法 Token 请求接口。观察服务端控制台日志，确认中间件日志先于 Handler 日志输出。

# 替换  为实际 Token
curl -H "Authorization: Bearer " http://127.0.0.1:8080/api/user

# 预期服务端日志输出顺序:
# [Middleware] User set, ID: 1001
# [Handler] Processing request for user 1001

常见坑与风险

• c.Next() 误用：标准中间件结构中，c.Next() 用于将控制权交给下一个 handler。如果在鉴权成功后没有调用 c.Next() 且没有 c.Abort()，请求会挂起或无法到达业务逻辑。
• 协程上下文丢失：不要在中间件里开启新 goroutine 处理业务逻辑后直接返回，Gin Context 不是协程安全的，也不能跨协程传递请求数据。
• 路由组隔离：如果中间件只注册在某个 Group 上，确保请求的路径确实属于该 Group。
• 日志脱敏：调试时严禁打印 Authorization Header 完整内容或用户密码字段，防止敏感信息泄露到日志系统。

参考来源

• gin-gonic/gin GitHub Repository, "Custom Middleware", https://github.com/gin-gonic/gin
• pkg.go.dev, "github.com/gin-gonic/gin.Context", https://pkg.go.dev/github.com/gin-gonic/gin#Context