頁面 A 執行耗時任務 (如爬蟲、導出、視頻轉碼) 並開啟 session_start()。同用戶在另一標籤頁訪問頁面 B (也需 Session),**頁面 B 一直白屏等待**,直到頁面 A 執行結束。
PHP 默認 Session Handler (files) 將會話數據存儲為文件:
session_start() → 獨佔鎖定 Session 文件 (防止並發寫入衝突)session_start() → **阻塞等待鎖釋放**session_write_close() → 寫入數據、釋放鎖這是**設計使然**,非 Bug。PHP 官方回應:"Session file is locked to avoid corruption."
<?php
// 頁面 A:耗時任務
session_start();
// 1. 讀取/驗證 Session (權限檢查、用戶身份)
$userId = $_SESSION['user_id'] ?? 0;
if (!$userId) exit('未登錄');
// 2. **關鍵:業務邏輯不再需要 Session 時,立即關閉寫入**
session_write_close(); // 釋放文件鎖,其他請求可並行訪問 Session
// 3. 執行耗時操作 (不再持有 Session 鎖)
sleep(30); // 模擬爬蟲/導出/轉碼
// ... 複雜業務邏輯 ...
// 4. 如需更新 Session (如進度條),可重新開啟
// session_start();
// $_SESSION['progress'] = 50;
// session_write_close();
echo "任務完成";
<?php
// common/session_helper.php
/** 安全啟動 Session (冪等) */
function sessionStart(): void
{
if (session_status() === PHP_SESSION_NONE) {
// 生產環境建議配置
ini_set('session.gc_maxlifetime', '7200');
ini_set('session.cookie_httponly', '1');
ini_set('session.cookie_samesite', 'Lax');
// ini_set('session.save_handler', 'redis'); // 高併發建議用 Redis
session_start();
}
}
/** 讀取 Session 後立即釋放鎖 */
function readSessionAndUnlock(string $key, mixed $default = null): mixed
{
sessionStart();
$value = $_SESSION[$key] ?? $default;
session_write_close(); // 關鍵:讀完即釋放
return $value;
}
/** 寫入 Session (快速寫入並釋放) */
function writeSession(array $data): void
{
sessionStart();
foreach ($data as $k => $v) {
$_SESSION[$k] = $v;
}
session_write_close();
}
/** 異步任務中更新進度 (短暫持有鎖) */
function updateProgress(int $progress): void
{
sessionStart();
$_SESSION['task_progress'] = $progress;
session_write_close(); // 立即釋放,前端輪詢可讀取
}
/** 完整登出 */
function destroySession(): void
{
sessionStart();
$_SESSION = [];
session_destroy();
// 刪除客戶端 Cookie
$params = session_get_cookie_params();
setcookie(session_name(), '', time() - 3600, $params['path'], $params['domain'], $params['secure'], $params['httponly']);
session_write_close();
}
// 前端每 2 秒輪詢 /api/progress
// 後端 api/progress.php
require 'session_helper.php';
echo json_encode(['progress' => readSessionAndUnlock('task_progress', 0)]);
// export.php
require 'session_helper.php';
$userId = readSessionAndUnlock('user_id');
if (!$userId) exit(json_encode(['error' => 'unauthorized']));
// 耗時生成文件...
$filePath = generateLargeExport($userId); // 30-300 秒
// 完成後若需記錄下載記錄
writeSession(['last_export' => time(), 'export_file' => basename($filePath)]);
header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename="' . basename($filePath) . '"');
readfile($filePath);
**API 接口無狀態化**,使用 JWT / API Token 驗證,**完全繞過 Session 鎖**:
// 中間件驗證 JWT
$payload = JWT::decode($token, $secret);
$userId = $payload->uid;
// 後續邏輯無需 session_start(),天然無阻塞
文件鎖本質是**單機文件系統鎖**,換用 **Redis / Memcached** 實現分佈式 Session,鎖粒度更細 (Redis 鎖)、支援集群:
; php.ini 或運行時設置
session.save_handler = redis
session.save_path = "tcp://127.0.0.1:6379?auth=password&database=1&prefix=session:"
// 或集群
session.save_path = "tcp://redis1:6379?weight=1, tcp://redis2:6379?weight=2"
// PHP 7.1+ 支持 redis session 鎖模式
ini_set('session.redis.lock_mode', '1'); // 1=自旋鎖, 2=阻塞鎖(默認)
ini_set('session.redis.lock_retries', '10');
ini_set('session.redis.lock_wait_time', '2000'); // 微秒
**注意**:Redis Session 仍有鎖 (防併發寫入覆蓋),但網絡延遲極低 (亞毫秒),且支援集群橫向擴展,不再受單機文件系統限制。
<?php
// debug_session_lock.php
session_start();
$start = microtime(true);
sleep(10); // 模擬耗時
$wait = microtime(true) - $start;
echo "持有鎖 $wait 秒\n";
session_write_close();
// 另一終端同時訪問此腳本,觀察等待時間
// 結合 xdebug + profile 分析鎖等待開銷
session_write_close()**,將鎖持有時間壓縮到毫秒級start → write → close 快速完成session_start 耗時,超過 100ms 即可能存在鎖爭用