必须正确配置Cookie与Session中间件,否则每次请求都会创建新会话;需在main.go中注册Session中间件(内存驱动仅限开发,生产必须用Redis),设置Cookie参数控制生命周期,HTTP处理器中通过gsession.Get获取会话、Set写入、Save保存、GetInt读取、Remove+Save退出登录。

在GoFrame框架中实现用户登录状态保持,必须正确配置Cookie与Session中间件,否则每次请求都会创建新会话,导致登录态无法延续。
启用Session中间件并设置存储驱动
第一步:在main.go初始化时调用ghttp.SetHandler前注册Session中间件,使用内存驱动仅适用于单机开发环境:
gf.New().Use(gsession.NewMemory())
第二步:若部署到多实例生产环境,必须切换为Redis驱动,否则不同服务器间会话不共享——【未配置Redis时用户可能登录成功却无法访问需鉴权的接口】:
redisClient := gredis.New(&gredis.Config{Addr: "127.0.0.1:6379"})
gf.New().Use(gsession.NewRedis(redisClient, "gf_session"))
第三步:Session ID默认通过Cookie传递,无需额外配置传输方式,框架自动处理Set-Cookie头与Cookie解析。
配置Cookie参数控制会话生命周期
方法一:全局配置(推荐)
在服务启动前调用gsession.SetConfig,设置过期时间、域名、路径等:
gsession.SetConfig(&gsession.Config{
MaxAge: 3600,
Path: "/",
Domain: "example.com",
Secure: true,
HttpOnly: true
})
方法二:按路由单独配置(适用于混合协议场景)
在特定路由组中使用中间件覆盖默认值:
r.Group("/api", gsession.New(&gsession.Config{MaxAge: 1800}))
记录结构化的Claude Code轨迹、影子git diff,并在代理行为需要法医级调试而非临时转录审查时回放分支。
注意:Secure设为true时,Cookie仅在HTTPS下发送,开发环境若未启用HTTPS会导致浏览器拒绝携带该Cookie,登录后立即失效。
在HTTP处理器中读写Session数据
① 获取当前会话对象:
s := gsession.Get(r.Context())
② 写入用户ID(字符串键名必须是合法标识符,含空格或特殊字符会panic):
s.Set("user_id", 12345)
③ 立即保存到后端存储(内存/Redis),这一步不可省略:
s.Save()
④ 读取时先判断键是否存在,避免nil panic:
if id := s.GetInt("user_id"); id > 0 { /* 处理已登录用户 */ }
⑤ 销毁会话(退出登录):
s.Remove() → s.Save()

















