CakePHP4数据库会话每次请求新增行问题求助

问题现象 #

使用CakePHP4的数据库会话时，每次请求都会在sessions表中新增一行记录，期望行为是更新现有会话记录，且不希望会话超时或用户重新登录。

相关配置与代码 #

bootstrap.php 会话配置 #

Configure::write('Session', array(
    'timeout' => 518400, //1 year,
    //'autoRegenerate' => true,    
    
    'defaults' => 'database',
    'handler' => [
        'engine' => 'ComboSession',
        'model' => 'Sessions'
    ],
    'ini' => array(
        'session.cookie_samesite' => 'none',
        'session.cookie_secure' => 'true'        
    )
));

ComboSession.php 自定义会话处理器 #

class ComboSession extends DatabaseSession
{
    protected $cacheKey;

    public function __construct()
    {
        parent::__construct();
    }

    // Read data from the session.
    public function read($id): string
    {
        Log::debug($id . '=>reading session');
        return parent::read($id);
    }

    // Write data into the session.
    public function write($id, $data): bool
    {
        Log::debug($id . '=>writing session=>' . print_r(debug_backtrace(2), true));
        parent::destroy($id);
        return parent::write($id, $data);
    }

    // Destroy a session.
    public function destroy($id): bool
    {
        Log::debug($id . '=>destroying a session');
        return parent::destroy($id);
    }

    // Removes expired sessions.
    public function gc($expires = null): bool
    {
        Log::debug($expires . '=>Calling Gc for a session');
        return parent::gc($expires);
    }
}

调用栈信息 #

2024-01-03 22:11:39 Debug: hkmra7g50t391n9o9hk7u9caur=>writing session=>Array
(
    [0] => Array
        (
            [function] => write
            [class] => App\Http\Session\ComboSession
            [type] => ->
        )

    [1] => Array
        (
            [file] => vendor\cakephp\cakephp\src\Http\Session.php
            [line] => 387
            [function] => session_write_close
        )

    [2] => Array
        (
            [file] => vendor\cakephp\cakephp\src\Http\Server.php
            [line] => 93
            [function] => close
            [class] => Cake\Http\Session
            [type] => ->
        )

    [3] => Array
        (
            [file] => webroot\index.php
            [line] => 40
            [function] => run
            [class] => Cake\Http\Server
            [type] => ->
        )

)

问题原因与解决方案 #

1. 自定义会话处理器的write方法逻辑错误 #

ComboSession的write方法中，先调用parent::destroy($id)删除现有会话记录，再执行parent::write($id, $data)。这会导致每次写入会话时，先删除原有记录，再插入新记录，而非更新。若会话ID因其他原因未被正确传递，还会生成多条新记录。

修复方法：移除write方法中的parent::destroy($id)调用，父类DatabaseSession的write方法默认会处理更新逻辑（存在则更新，不存在则插入）：

public function write($id, $data): bool
{
    Log::debug($id . '=>writing session=>' . print_r(debug_backtrace(2), true));
    return parent::write($id, $data);
}

2. 检查Session Cookie的有效性 #

配置中设置了session.cookie_secure = true，这要求会话Cookie只能通过HTTPS协议传输。若当前网站运行在HTTP环境下，浏览器会拒绝保存该Cookie，导致每次请求都会生成新的会话ID，进而在数据库中新增记录。

检查项：

• 确认网站部署在HTTPS环境中；
• 若需在HTTP环境测试，可临时将session.cookie_secure设为false（生产环境不建议）。

3. 验证Sessions表结构 #

确保sessions表的主键为id字段，类型与会话ID长度匹配（如CHAR(40)或VARCHAR(255)）。主键异常会导致数据库无法正确识别现有记录，从而执行插入而非更新操作。

4. 确认会话ID未被自动重置 #

配置中已注释autoRegenerate = true，该设置正确，开启后会自动生成新的会话ID，导致新增记录。无需修改此配置。

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