“用户反馈登录一会儿就掉线”——这类问题的排查要从 Session 的生命周期开始。Session 由三部分组成:客户端 Cookie 里的 session_id、服务端的存储、以及过期策略。任何一环出问题,表现都是”掉登录”。
先确认 Session 是否真的启动
<?php
session_start();
var_dump(session_id(), session_status());
// PHP_SESSION_ACTIVE = 2 才算正常启动
常见原因清单
| 现象 | 可能原因 |
|---|---|
| 刷新就掉 | session_id 没写进 Cookie,或 Cookie 的 path/domain 不匹配 |
| 换页面掉 | 不同子域各自开 Session,未设 cookie domain |
| 几分钟就掉 | session.gc_maxlifetime 太短,或 GC 概率过高 |
| 偶发掉线 | 并发请求互相覆盖 Session 文件 |
| https 下掉 | Cookie 设了 secure,但站点仍是 http |
关键配置
; 有效期(秒),默认 1440 即 24 分钟
session.gc_maxlifetime = 7200
; GC 触发概率,默认 1/100,请求量大时容易误删活跃会话
session.gc_probability = 0
session.gc_divisor = 1000
; Cookie 参数
session.cookie_lifetime = 0 ; 0 表示关闭浏览器失效
session.cookie_httponly = 1
session.cookie_secure = 1 ; 仅 https
session.cookie_samesite = Lax
; 存储位置,多站点务必分开
session.save_path = "/var/lib/php/sessions"
并发写冲突
PHP 的 Session 文件默认会加锁:同一个 session_id 的请求是串行的。这本来是保护机制,但在”页面同时发多个 AJAX 请求”时会互相等待,甚至因为后一个请求覆盖前一个的写入而丢数据。
解决办法是尽早 session_write_close():读完需要的数据就释放锁,不要在整个请求周期都占着。
<?php
session_start();
$uid = $_SESSION['uid'] ?? 0;
session_write_close(); // 立刻释放锁,后续逻辑不再阻塞其它请求
// 需要再写时重新打开
session_start();
$_SESSION['last_seen'] = time();
session_write_close();
分布式部署怎么办
多台机器时,Session 文件不共享,必须换成集中存储。两种常见方案:Redis 存 Session,或改用 JWT 等无状态令牌。前者改动小,后者扩展性好但要注意吊销问题。
<?php
ini_set('session.save_handler', 'redis');
ini_set('session.save_path', 'tcp://127.0.0.1:6379?database=2');
安全提醒
登录成功后一定要 session_regenerate_id(true),防止会话固定攻击。这一行代码很多项目都漏了,属于低成本高收益的加固。
本文为 PHP 学习与排错的经验整理。示例代码以通用环境为前提,请结合自身 PHP 版本与服务器配置调整;涉及生产环境的变更,建议先备份并在测试环境验证。