Go语言Gin框架中实现基于Cookie的简单会话-Golang-PHP中文网

gin默认不带会话支持，因其是极简http框架，仅提供基础cookie工具（如c.cookie()、c.setcookie()），不内置服务端状态维护机制，故无法直接调用c.session()。

go语言gin框架中实现基于cookie的简单会话

为什么 Gin 默认不带会话支持

Gin 本身是个极简 HTTP 框架，gin.Engine 不内置 session 管理——它连 Cookie 解析都只提供基础工具（如 c.Cookie()、c.SetCookie()），更不用说服务端状态维护。这意味着：你不能直接调用 c.Session()，否则会报 undefined: c.Session。

要实现基于 Cookie 的简单会话，核心思路是「自己生成并校验签名 Cookie」，而非依赖外部 session store。适合轻量场景（比如用户登录态维持几小时、无需集群共享）。

用 `gorilla/sessions` 快速启用 Cookie 会话

最稳妥的方案是复用成熟库：gorilla/sessions 提供了加密、签名、过期控制等完整能力，且与 Gin 兼容良好。它把 session 数据序列化后存入加密的 Cookie，服务端无状态，部署简单。

安装：go get github.com/gorilla/sessions
初始化 store 时必须设置密钥（至少 32 字节），否则启动报错：http: named cookie jar not registered 或签名失效
推荐使用 cookie.NewStore()，避免引入 Redis 等额外依赖
务必调用 store.Options 设置 HttpOnly 和 Secure（HTTPS 环境下）

示例初始化：

store := sessions.NewCookieStore([]byte("your-32-byte-secret-key-here-xxxxxx"))
store.Options = &sessions.Options{
    Path:     "/",
    MaxAge:   3600, // 1 小时
    HttpOnly: true,
    Secure:   false, // 开发环境设为 false；生产 HTTPS 环境设为 true
}

在 Gin handler 中读写 session

关键点在于：每次请求需从 *gin.Context 提取 *http.Request，再传给 store.Get()；写入后要显式调用 session.Save()，否则 Cookie 不会下发。

NotebookLM CLI Cookies

使用 nlm CLI 检索并回答已上传至 NotebookLM 的文档问题。适用于用户需要查找信息、总结来源或查询特定笔记本时。

下载

sessions.DefaultMaxAge 是零值（永不过期），必须显式设 MaxAge 或 Expires
存任意可序列化结构体或 map，但避免存大对象（Cookie 有 4KB 限制）
删除字段用 session.Delete("key")，清空用 session.Options.MaxAge = -1 再 Save()
注意并发：每个请求应获取独立 *sessions.Session 实例，不要跨 goroutine 复用

典型用法：

func loginHandler(c *gin.Context) {
    session, _ := store.Get(c.Request, "mysession")
    session.Values["user_id"] = 123
    session.Values["role"] = "admin"
    session.Save(c.Request, c.Writer)
    c.JSON(200, gin.H{"msg": "logged in"})
}

func profileHandler(c *gin.Context) {
    session, _ := store.Get(c.Request, "mysession")
    if uid, ok := session.Values["user_id"]; ok {
        c.JSON(200, gin.H{"user_id": uid})
    } else {
        c.AbortWithStatus(401)
    }
}