CodeIgniter 4升级后异步AJAX并发请求出现session_lock错误

算力阿峰

2026-7-18

解决CodeIgniter 4 + PHP 8.2 下Memcached Session并发AJAX锁问题

方案1：精准释放Session锁

对于不需要修改Session的AJAX请求，在控制器开头立即调用 session()->close()，避免长时间持有锁。

如果请求需要修改Session，完成修改后立刻调用session()->close()，别等脚本结束再释放。
示例代码：

public function ajaxNoSessionUpdate()
{
    // 提前释放锁
    session()->close();
    // 处理AJAX逻辑
    return $this->response->setJSON(['data' => 'xxx']);
}

public function ajaxWithSessionUpdate()
{
    // 修改Session数据
    session()->set(['user_last_active' => time()]);
    // 写完立刻释放锁
    session()->close();
    // 后续处理逻辑
    return $this->response->setJSON(['status' => 'ok']);
}

方案2：调整Memcached Session锁配置

在app/Config/App.php里修改Session相关配置，优化锁的行为：

确保驱动设置正确：$sessionDriver = 'CodeIgniter\Session\Handlers\MemcachedHandler';

在$sessionConfig数组里添加锁相关参数：

public $sessionConfig = [
    'memcached' => [
        'host' => '127.0.0.1',
        'port' => 11211,
        'weight' => 1,
    ],
    'lock_expire' => 3, // 缩短锁过期时间为3秒
    'lock_retries' => 2, // 增加锁获取重试次数
];

原理：缩短锁的有效期，让并发请求能更快获取到释放的锁，减少锁冲突概率。

方案3：无状态AJAX请求直接禁用Session

如果某些AJAX请求完全不需要Session（比如获取公共数据的接口），可以在控制器构造方法里跳过Session初始化：

public function __construct()
{
    parent::__construct();
    // 匹配不需要Session的AJAX请求路径
    $noSessionPaths = ['api/public-data', 'api/other-no-session'];
    if ($this->request->isAJAX() && in_array($this->request->getUri()->getPath(), $noSessionPaths)) {
        // 移除Session共享实例，避免自动初始化
        \CodeIgniter\Config\Services::removeShared('session');
    }
}