sessions.new 是 iris 中创建 session 实例的唯一入口，必须在路由注册前初始化并调用 sess.handler() 挂载为中间件，否则 ctx.session() 会 panic；session 实例按请求独享，自动持久化，支持 memory/redis 等可插拔后端。
sessions.New 是 Iris 中创建 Session 实例的唯一入口，不调用它就无法启用会话管理——哪怕你写了 ctx.Session().Set()，也会 panic：nil pointer dereference。
sessions.New 必须在路由注册前初始化
Iris 的 Session 不是全局自动启用的中间件，它是一个独立对象，需手动注入到请求上下文链中。常见错误是把 sessions.New 放在某个 handler 里，或者放在 app.Get 之后：
app.Get("/login", func(ctx iris.Context) {
sess := sessions.New(sessions.Config{Cookie: "my_session"}) // ❌ 错！每次请求都新建，ID 不一致，数据不延续
sess.Start(ctx).Set("uid", 123)
})
正确做法是在 app 实例创建后、任何路由注册前完成初始化，并通过中间件挂载：
sess := sessions.New(sessions.Config{
Cookie: "my_session",
Expires: 24 * time.Hour,
})
app.Use(sess.Handler()) // ✅ 必须挂载，否则 ctx.Session() 返回 nil
-
sess.Handler()是必须调用的中间件，它负责从请求中解析 Session ID、加载对应 session 数据、绑定到ctx.Session() - 若漏掉这行，所有
ctx.Session()操作都会 panic
ctx.Session() 返回的是当前请求绑定的会话实例
这个实例不是全局单例，而是每次请求独享（但背后共享同一存储）。它的生命周期只覆盖当前 HTTP 请求：
-
ctx.Session().Set("key", value)写入的是本次会话的数据，不是内存变量 -
ctx.Session().GetString("key")读取的是服务端存储中该 Session ID 对应的值 - 同一浏览器发起的后续请求，只要 Cookie 携带有效
my_session值，就能读回之前写入的内容
注意：
Session Handoff
下载
创建全面的交接文档，使新AI代理能够无缝继续工作，消除歧义。解决上下文耗尽问题。 时机：(1)用户请求保存交接，(2)上下文即将满，(3)主要任务完成，(4)会话结束，(5)恢复工作时。 关键词：保存状态、创建交接、上下文已满、暂停、从...恢复、加载交接、保存进度、会话转移、交接
-
Set后无需手动Save—— Iris 默认在响应写出前自动持久化（除非你显式禁用） - 如果用了
redis或memcache存储后端，Set立即触发网络写入；内存模式则仅存于进程内 map，重启即丢
Session 数据类型限制与 GetXXX 方法陷阱
Iris 的 session 对象提供类型安全的读取方法，但它们不会做类型转换，只做断言：
-
session.GetInt("count")要求你之前用Set("count", 42)存过int，如果存的是"42"（字符串），会返回0, false -
session.GetString("name")同理，只接受原始string类型，不能从json.RawMessage或interface{}自动转
常见踩坑点：
- 用
Set("data", map[string]interface{}{"a": 1})存结构体，再用Get("data")取出后直接类型断言为map[string]int→ panic - 期望
GetFloat64能把字符串"3.14"自动解析 → 实际返回0, false
安全做法：
- 存的时候明确类型：
Set("price", 3.14)（float64）而非"3.14" - 读的时候用
Get+ 类型断言或json.Unmarshal处理复杂结构
Session 的核心不在“怎么存”，而在“谁来管生命周期”。Iris 把存储解耦成可插拔后端（memory/redis/cookie），但开发者最容易忽略的是：Session ID 的传递是否可靠、过期逻辑是否与业务匹配、并发写入是否被覆盖——这些不靠文档，得看实际请求头、响应 Set-Cookie 字段和存储后端日志。
