thinkphp5 session 问题主因是 prefix 不一致、redis 未显式 init、误用 session() 参数及作用域混淆；正确做法是统一 prefix、手动 init 外部驱动、用 null 删除键、区分 flash/pull 生命周期。
ThinkPHP5 的 Session 不是直接操作 $_SESSION，而是封装了一层作用域和前缀控制，用错地方就拿不到值、删不掉、跨请求失效——尤其在多模块或 Redis 存储时，prefix 和 type 配置不匹配是最高频的“明明设了却取不到”的原因。
session() 助手函数怎么传参才不踩坑
它不是“一个函数干所有事”，而是靠参数组合触发不同行为，传错类型会静默失败：
- 传字符串 + 值：
session('user', 'admin')→ 当前作用域赋值（默认 prefix 是think） - 传字符串 +
null：session('user', null)→ 删除当前作用域的user - 传字符串 + 无第二参数：
session('user')→ 取当前作用域值，不存在返回null - 传
?key：session('?user')→ 判断是否存在（比session('user') !== null更准） - 传
null：session(null)→ 清空当前作用域全部 session（不是整个$_SESSION） - 传数组：
session(['prefix' => 'admin', 'auto_start' => true])→ 初始化，仅首次有效
⚠️ 注意：session('user', '') 不是删除，而是把值设为空字符串；要删必须用 null。
Session::set() 和 Session::get() 的作用域陷阱
TP5 默认给所有 session 加了前缀（如配置里 'prefix' => 'think'），所以 Session::set('user', 'a') 实际存的是 $_SESSION['think']['user']，不是 $_SESSION['user']：
- 跨模块读写要统一 prefix：比如后台用
Session::set('user', 'a', 'admin')，前台就得用Session::get('user', 'admin') -
Session::prefix('admin')可临时切换当前作用域，但只对后续调用生效，不影响之前已 set 的值 - 二维键名支持点号：
Session::set('auth.role', 'editor')等价于$_SESSION['think']['auth']['role']，但不能混用数组语法（如Session::set(['auth.role' => 'editor'])无效）
常见错误：在控制器里用 Session::set('user', ...)，模板里却写 {$Think.session.user} 拿不到——因为模板读的是 $_SESSION['think']['user']，而你没确认 prefix 是否一致。
闪存（flash）和 pull 的生命周期容易混淆
Session::flash() 和 Session::pull() 都是一次性读取+清除，但触发时机不同：
-
Session::flash('msg', 'ok')：当前请求设值，**下一次 HTTP 请求时自动取出并清空**；适合跳转后提示（如登录成功跳首页，首页显示提示） -
Session::pull('msg')：**本次请求立即取值并删掉**，适合表单提交后立刻反馈（如 AJAX 提交后弹 toast） - 两者都依赖当前作用域，
Session::flash('msg', 'ok', 'admin')必须用Session::pull('msg', 'admin')才能拿到
⚠️ 如果用了 Session::flash() 却没发生重定向或页面刷新，值会一直留着直到下次请求——这不是 bug，是设计如此。
Redis 存储时 init() 必须显式调用
文件存储下 auto_start => true 能自动初始化，但 Redis/Memcached 等外部驱动需要手动触发 init()，否则 Session::set() 会静默失败：
- 在控制器构造函数或
_initialize()中加：Session::init(['type' => 'redis', 'host' => '127.0.0.1']) - 配置文件里写了
'type' => 'redis'但没开auto_start，也得手动 init - Redis 连接失败时不会报错，只会退化成空 session，排查时先
dump(Session::get())看是否返回空数组
真正麻烦的不是“怎么写”，而是“为什么写了没效果”——90% 的问题出在 prefix 不一致、驱动未初始化、或误以为 session('key') 直接映射 $_SESSION['key']。别绕过配置看文档，先确认 config/session.php 里的 prefix 和 type 是什么，再决定用助手函数还是类方法。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
