CakePHP4结合Redis Cluster场景下AJAX请求无法保存Session问题问询

该问题由CakePHP4的会话处理机制与原生$_SESSION操作的冲突导致，具体逻辑如下：

• CakePHP4通过SessionMiddleware全生命周期接管会话处理：请求进入时会从Redis Cluster读取完整Session数据，存储到自身维护的内存快照中；请求完全结束后，会将该内存快照全量写回Redis，该写入操作优先级高于PHP原生的会话自动写入。
• 直接修改原生$_SESSION时，PHP内置会话处理器会触发一次新值写入（即你监控到的第一次写入），但该修改不会同步到CakePHP的内存快照中，请求结束时CakePHP会将未更新的旧快照再次写入Redis，直接覆盖之前的新值，也就是你看到的第二次旧值写入。
• 加sleep生效的本质是强制延长请求生命周期，让PHP原生写入的时机晚于CakePHP的自动写入，属于不可靠的巧合方案。原生PHP无此问题是因为仅存在请求结束时的一次自动写入，没有额外的快照覆盖逻辑。

方案1：使用CakePHP官方Session API操作（最优） #

CakePHP官方不建议直接操作$_SESSION，统一使用框架提供的Session方法修改数据，可保证内存快照同步更新，不会出现覆盖问题。代码修改如下：

public function ajaxAction()
{
    $this->disableAutoRender();
    $treeId = (int) $this->request->getData('treeId');
    $session = $this->getRequest()->getSession();
    
    $myArray = $session->read('myArray') ?? [];
    var_dump($myArray);
    
    $myArray[$treeId] = true;
    $session->write('myArray', $myArray);
    
    var_dump($session->read('myArray'));
    // 可选：主动关闭会话提前触发写入
    $session->close();
}

方案2：关闭CakePHP自动会话持久化（适配历史代码场景） #

如果项目中有大量直接操作$_SESSION的历史代码无法快速改造，可以修改config/app.php中的Session配置，关闭CakePHP的自动写入逻辑，由PHP原生会话处理器接管写入：

return [
    // 其他配置省略
    'Session' => [
        'defaults' => 'redis',
        'handler' => [
            'config' => '你的Redis Cluster配置名',
            // 新增该配置关闭CakePHP自动持久化
            'persist' => false,
        ],
        'timeout' => 86400,
    ],
];

方案3：逻辑结束后主动终止请求 #

如果不想修改现有业务代码和配置，可以在接口逻辑完成后主动关闭会话并终止请求，跳过CakePHP中间件后续的旧值写入逻辑：

public function ajaxAction()
{
    $this->disableAutoRender();
    $treeId = (int) $this->request->getData('treeId');
    var_dump($_SESSION['myArray']);
    $_SESSION['myArray'][$treeId] = true;
    var_dump($_SESSION['myArray']);
    
    // 主动写入会话并终止请求
    session_write_close();
    exit;
}

内容的提问来源于stack exchange，提问作者PlatypusGeek