ThinkPHP会话丢失需四层逐级排查：服务端未激活（session_status()返回false）、文件驱动写入失败（权限/路径问题）、Cookie未携带（跨域/HTTPS配置错误）、Redis读取异常（prefix非法或serialize配置错误）。

ThinkPHP会话丢失，不是随机发生的故障，而是特定环节断开导致的链路失效。核心问题往往不在“有没有启动Session”，而在于“有没有真正写入、能否被正确读取、是否被前端成功携带”。排查要从服务端初始化、存储层、传输层、客户端四层逐级验证。

Session根本没激活

执行 var_dump(session_status() === PHP_SESSION_ACTIVE)，返回 false 就说明 Session 还没启动。常见原因：

• TP8.0 默认禁用原生 session_start()，若配置了 'type' => 'redis' 但 Redis 未连接，会静默降级为空实现，session_id() 返回空字符串
• 中间件中 think\middleware\SessionInit::class 位置靠后（比如在路由或鉴权之后），导致控制器首次调用 $this->request->session() 时 Session 尚未初始化
• 临时验证可在 app/common.php 顶部加 session_start()，若此时恢复则确认是中间件顺序问题（注意：上线前必须删掉）

文件驱动写入失败（最常见）

默认 file 驱动下，不报错但 session('key') 始终为空，大概率是路径权限问题：

Remix V2 Meta Sessions Review

审查 Remix v2 代码中的 v1 形态 meta 导出（v2 中为破坏性变更），cookie 安全漏洞（httpOnly、secure、密钥轮换），认证门位于错误层级，以及其他

下载

• 运行 php -r "echo session_save_path();" 查看实际写入路径，不是 config 里写的路径，而是 PHP 运行时生效的路径
• 进入该目录，检查 Web 用户（如 www-data、nginx）是否有 rwx 权限；Docker 环境中 /tmp 常被挂载为只读，需显式指定 'path' => runtime_path('session')
• 手动创建 runtime/session 并赋权：mkdir -p runtime/session && chmod -R 777 runtime/session
• 临时切到 'type' => 'cache' 验证，若恢复则基本锁定是文件驱动环境问题

Cookie传不过去（跨域/HTTPS/子域高频坑）

浏览器没把 PHPSESSID 发给服务端，服务端就只能新建会话：

立即学习“PHP免费学习笔记（深入）”；

• Ajax 请求必须设 credentials: 'include'（fetch）或 withCredentials: true（axios/XHR），否则 Cookie 不随请求发出
• 后端响应头必须同时满足：Access-Control-Allow-Credentials: true + Access-Control-Allow-Origin 不能为 *，必须写具体域名（如 https://admin.example.com）
• HTTP 环境下，'secure' => true 会导致浏览器拒绝保存 Cookie；本地开发慎用 domain => '.localhost'，应留空或设为 ''
• 跨子域需统一 domain => '.example.com'，并确保所有子域都走 HTTPS 或都走 HTTP，混合协议会丢 Cookie

Redis 驱动读不到数据

Redis 写成功但读返回 null，多因序列化或键名不匹配：

• 检查 'prefix' 是否含空格、中文等非法字符，Redis 键名拼接后无法 GET
• 'serialize' 必须为 false（默认值），开启后若 Redis 存的是字符串，TP 尝试反序列化就会静默失败
• 用 redis-cli 执行 KEYS 'think_session_*' 看键是否存在，再 GET 具体键值，判断是写入失败还是解码失败
• 若用 Predis 客户端，需在 config/session.php 中显式配置 'handler' 指向 Predis\Handler 实例，否则驱动自动降级为 file