Gin框架Redis会话管理报错：指定Key不存在的问题求助

问题根源 #

你在初始化会话中间件时指定了自定义会话Key：sessions.Sessions("recipes_api", store)，这会让中间件将会话实例存储到Gin Context的"recipes_api"键下。但你在Handler中调用Default(c)方法时，该方法默认会尝试从Context的**默认键（github.com/gin-gonic/contrib/sessions）**获取会话实例，两者键不匹配，因此触发Key does not exist的panic。

另外你混用了两个不同路径的会话包（github.com/gin-gonic/contrib/sessions和github.com/gin-contrib/sessions），这两个包实际是同一项目的新旧路径，容易导致版本和上下文键的混乱，建议统一使用当前维护的新路径：github.com/gin-contrib/sessions。

解决方案 #

有两种方式可以解决这个问题：

方案1：使用自定义Key获取会话 #

在Handler中，不要用Default(c)，而是通过你初始化时指定的自定义Key来获取会话：

// auth handler
import (
    //...
    "crypto/sha256"
    "github.com/dgrijalva/jwt-go"
    sessions "github.com/gin-contrib/sessions"
    //...
)
 
func (handler *AuthHandler) SignInHandler(c *gin.Context) {
//...
    sessionToken := xid.New().String()
    // 使用自定义Key获取会话
    session, ok := sessions.Get(c, "recipes_api").(sessions.Session)
    if !ok {
        c.JSON(http.StatusInternalServerError, gin.H{"error": "Failed to get session"})
        return
    }
    session.Set("username", user.Username)
    session.Set("token", sessionToken)
    if err := session.Save(); err != nil {
        c.JSON(http.StatusInternalServerError, gin.H{"error": "Failed to save session"})
        return
    }
    c.JSON(http.StatusOK, gin.H{"message": "User signed in"})
}

方案2：使用默认Key初始化中间件 #

如果你想继续使用Default(c)方法，那么初始化中间件时不要指定自定义Key，改用包的默认Key：

// main.go
import (
    "context"
    sessions "github.com/gin-contrib/sessions"
    redisStore "github.com/gin-contrib/sessions/redis"
    "github.com/gin-gonic/gin"
 )

router := gin.Default()
// 使用默认Key初始化中间件（第一个参数传空字符串或sessions.DefaultKey）
store, err := redisStore.NewStore(10, "tcp", "localhost:6379", "", []byte("secret"))
if err != nil {
    panic(err) // 不要忽略错误，初始化失败直接终止程序
}
router.Use(sessions.Sessions("", store))
// 或者显式指定默认Key：router.Use(sessions.Sessions(sessions.DefaultKey, store))

然后在Handler中就可以正常使用Default(c)：

session := sessions.Default(c)
session.Set("username", user.Username)
session.Set("token", sessionToken)
if err := session.Save(); err != nil {
    c.JSON(http.StatusInternalServerError, gin.H{"error": "Failed to save session"})
    return
}

额外注意事项 #

1. 不要忽略错误：你的代码中store, _ := sessions.NewRedisStore(...)忽略了初始化错误，建议加上错误处理，避免Redis连接失败时程序静默出错。
2. 统一包路径：彻底替换所有旧路径的导入，全部使用github.com/gin-contrib/sessions及其子包（如redisStore "github.com/gin-contrib/sessions/redis"），避免版本冲突。

内容的提问来源于stack exchange，提问作者black sensei