PHP内置redis handler不支持Redis集群分片逻辑，需用phpredis≥5.0的RedisCluster类配合{xxx} hash tag自定义SessionHandler实现；否则session.save_handler=redis在集群下会因随机路由导致读写失败。
PHP默认的文件型Session在多服务器部署下无法共享，直接切到Redis单节点虽能解决跨服问题，但扛不住故障或扩容压力。真要上生产，必须用Redis集群 + phpredis扩展支持的原生集群模式，否则MOVED重定向会失败，Session读写随机中断。
session.save_handler=redis 在集群下为什么不起作用
PHP内置的redis handler只支持单节点或主从（靠redis.replicaof），不识别Redis Cluster的16384个slot分片逻辑。当你把session.save_path设成多个地址如"tcp://a:7000,tcp://b:7001"，它不会自动做CRC16哈希和重定向，而是随机连一个节点——结果就是SET PHPREDIS_SESSION:abc123 ...可能发到A节点，但GET PHPREDIS_SESSION:abc123被路由到B节点，返回null。
必须满足两个条件才能走通集群：
- phpredis扩展版本 ≥ 5.0（低于此版本
RedisCluster类不存在） - PHP配置中
session.save_handler不能设为redis，而要设为user，再用自定义SessionHandlerInterface接管
用RedisCluster类手动接管Session读写
绕过PHP内置handler，自己实现read()/write()，底层用RedisCluster实例操作。关键点在于：Session key必须带{...} hash tag，否则集群无法保证同一session_id始终落在同一个slot。
立即学习“PHP免费学习笔记（深入）”；
示例片段：
创建全面的交接文档，使新AI代理能够无缝继续工作，消除歧义。解决上下文耗尽问题。 时机：(1)用户请求保存交接，(2)上下文即将满，(3)主要任务完成，(4)会话结束，(5)恢复工作时。 关键词：保存状态、创建交接、上下文已满、暂停、从...恢复、加载交接、保存进度、会话转移、交接
class RedisClusterSessionHandler implements SessionHandlerInterface
{
private $cluster;
private $prefix = 'PHPREDIS_SESSION:';
public function __construct(array $nodes)
{
$this->cluster = new RedisCluster(NULL, $nodes);
}
public function read($id)
{
// 强制hash到同一slot：{PHPREDIS_SESSION:abc123} → 只取{}内字符串哈希
return $this->cluster->get($this->prefix . '{' . $id . '}') ?: '';
}
public function write($id, $data)
{
$key = $this->prefix . '{' . $id . '}';
$lifetime = (int)ini_get('session.gc_maxlifetime');
return $this->cluster->setex($key, $lifetime, $data);
}
// open/close/destroy 略，需返回true
}
注册时用：
$handler = new RedisClusterSessionHandler([
'tcp://192.168.1.10:7000',
'tcp://192.168.1.11:7001',
'tcp://192.168.1.12:7002'
]);
session_set_save_handler($handler, true);
session_start();
连接串里auth、timeout、retry这些参数怎么填
session.save_path在单节点模式下支持URL参数（如?auth=xxx&connect_timeout=2），但RedisCluster构造函数不解析这些——它只认纯地址数组。所有连接控制得在代码里显式设置：
- 密码必须调用
$cluster->auth('yourpass')，且要在第一次读写前执行 - 超时和重试需在创建
RedisCluster时传入options数组：['timeout' => 2.0, 'read_timeout' => 2.0, 'retry_interval' => 100] - 如果集群启用了TLS（如
rediss://），phpredis ≥ 5.3.4才支持，且要编译时链接OpenSSL
漏掉auth会导致NOAUTH Authentication required错误；没设timeout则默认是0（无限阻塞），网络抖动时整个PHP请求卡死。
验证Session是否真在集群里均匀分布
别只看redis-cli -c -h x -p y get PHPREDIS_SESSION:xxx能取到值就认为OK。集群下必须确认三件事：
- 用
redis-cli -c连任意节点，执行CLUSTER KEYSLOT {PHPREDIS_SESSION:xxx}，得到slot号；再查该slot归属节点：CLUSTER GETKEYSINSLOT <slot> 1</slot>→CLUSTER NODES比对IP - 检查各节点内存使用是否均衡：
INFO memory | grep used_memory_human，偏差超过30%说明hash tag没生效或节点权重不均 - 模拟主节点宕机：
redis-cli -h downed_ip shutdown，观察应用是否在3秒内自动切到从节点继续读写（需集群配置cluster-require-full-coverage no）
最容易被忽略的是{} hash tag位置——必须包住整个session_id，写成{PHPREDIS_SESSION:xxx}或PHPREDIS_SESSION:{xxx}都无效，只有PHPREDIS_SESSION:{xxx}才对（注意花括号紧贴id）。少一个字符，集群就当它是不同key，分散到不同slot，Session就丢了。
