萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 「Allowed memory size exhausted」記憶體耗盡錯誤:根因分析與三種解決方案

遇到 Fatal error: Allowed memory size of 134217728 bytes exhausted (tried to allocate 20480 bytes) 別慌。這不只是「記憶體不夠」,更可能是程式邏輯錯誤的信號。本文教您系統化排查根因、精準修復,而非單純調大 memory_limit 掩蓋問題。

第一步:區分「真不夠」vs「程式漏洞」

特徵真記憶體不足程式漏洞 (記憶體洩漏/無限迴圈)
錯誤發生時間處理大量資料時 (匯出、圖片處理、大檔案讀取)處理少量資料、固定流程、特定輸入即觸發
錯誤訊息中的 tried to allocate較大 (MB 級)極小 (bytes 級) 或固定值
記憶體成長曲線線性/階梯狀隨資料量增長指數級/鋸齒狀/持續上升不釋放
重現性資料量達閾值必現特定條件觸發,可能間歇性

排查工具與方法

  1. 記憶體分析器:memory_get_usage(true) (真實分配)、memory_get_peak_usage(true) (峰值)
  2. Xdebug + Webgrind:生成呼叫圖,找出記憶體增長最快的函式
  3. Blackfire.io:生產級效能分析,含記憶體時間線
  4. 手動埋點:關鍵節點記錄 memory_get_usage() 到日誌

快速定位代碼片段

<?php
function memCheck(string $label): void {
    $mem = memory_get_usage(true) / 1024 / 1024;
    $peak = memory_get_peak_usage(true) / 1024 / 1024;
    error_log("[$label] Current: ${mem}MB, Peak: ${peak}MB");
}

// 使用範例
memCheck('start');
$largeArray = range(1, 1000000);
memCheck('after range');
$processed = array_map(fn($x) => $x * 2, $largeArray);
memCheck('after map');
unset($largeArray);
memCheck('after unset');
gc_collect_cycles();
memCheck('after gc');

三種解決方案 (由輕到重)

方案一:修正程式邏輯 (根治,最推薦)

  • 生成器 (Generator) 替代陣列:大資料集逐行處理,不一次載入記憶體
    // ❌ 一次載入百萬行 -> 記憶體爆炸
    $lines = file('huge.log');
    foreach ($lines as $line) { process($line); }
    
    // ✅ 生成器逐行讀取 -> 記憶體恆定
    function readLines(string $file): Generator {
        $handle = fopen($file, 'r');
        while (($line = fgets($handle)) !== false) {
            yield rtrim($line);
        }
        fclose($handle);
    }
    foreach (readLines('huge.log') as $line) { process($line); }
    
  • 資料庫游標/分批查詢:避免 fetchAll() 一次載入全部結果
    $stmt = $pdo->prepare('SELECT * FROM huge_table');
    $stmt->execute();
    while ($row = $stmt->fetch(PDO::FETCH_ASSOC)) { // 逐行取得
        process($row);
    }
    
  • 及時 unset() 大變數 + gc_collect_cycles():釋放循環引用佔用的記憶體
  • 檢查無限遞迴/迴圈:遞迴需有明確終止條件,迴圈變數確實更新

方案二:運行時調整 memory_limit (臨時緩解)

<?php
// 單一腳本臨時提升 (僅影響當前腳本)
ini_set('memory_limit', '512M'); // 或 '2G', '-1' (無限制,極度危險)

// 檢查當前限制
echo ini_get('memory_limit'); // 128M
  • 適用:一次性匯出報表、圖片處理、Composer install 等已知需大量記憶體的離線任務
  • 禁止:長期運行的 Web 請求、API、佇列消費者 (會掩蓋洩漏導致 OOM Kill)

方案三:配置檔案永久調整 (系統級)

; php.ini (生產環境建議 256M-512M)
memory_limit = 256M

; .htaccess (Apache 模組模式)
php_value memory_limit 256M

; .user.ini (PHP-FPM / CGI 模式)
memory_limit = 256M

; Docker / Kubernetes
# Dockerfile
ENV PHP_MEMORY_LIMIT=512M
# 或啟動時覆蓋
CMD php -d memory_limit=512M -S 0.0.0.0:8000
⚠️ 重要:修改配置後必須重啟 PHP-FPM / Apache 生效。php -i | grep memory_limit 驗證。

生產環境記憶體管理黃金法則

  1. 設定合理上限:Web 請求 128M-256M,CLI 任務 512M-1G,絕不設 -1
  2. 監控告警:Prometheus 監控 php_memory_usage_bytes、php_memory_peak_bytes,超過 80% 告警
  3. OOM Killer 防護:Linux oom_score_adj 降低 PHP-FPM 被殺優先級,但不可依賴此機制
  4. 定期重啟 Worker:PHP-FPM pm.max_requests = 500 防止長期運行洩漏累積
  5. 啟用 OPcache:opcache.enable=1、opcache.memory_consumption=256,減少編譯記憶體佔用

實戰案例:匯出 10 萬筆資料到 Excel

<?php
// ❌ 錯誤:一次查所有、一次建構整個 Spreadsheet 物件
$allData = $pdo->query('SELECT * FROM orders')->fetchAll();
$spreadsheet = new Spreadsheet();
// ... 寫入 10 萬行 -> 記憶體 > 500MB

// ✅ 正確:分批查詢 + 串流寫入
$batchSize = 1000;
$offset = 0;
$spreadsheet = new Spreadsheet();
$writer = new \PhpOffice\PhpSpreadsheet\Writer\Xlsx($spreadsheet);
$writer->setUseDiskCaching(true); // 磁碟暫存

header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
header('Content-Disposition: attachment; filename="orders.xlsx"');

$firstBatch = true;
while (true) {
    $stmt = $pdo->prepare('SELECT * FROM orders LIMIT ? OFFSET ?');
    $stmt->execute([$batchSize, $offset]);
    $rows = $stmt->fetchAll(PDO::FETCH_ASSOC);
    if (empty($rows)) break;
    
    $sheet = $spreadsheet->getActiveSheet();
    if ($firstBatch) {
        $sheet->fromArray(array_keys($rows[0]), null, 'A1'); // 表頭
        $firstBatch = false;
    }
    $sheet->fromArray($rows, null, 'A' . ($offset + 2));
    $offset += $batchSize;
    
    // 關鍵:定期輸出緩衝區 (需搭配 ob_flush/flush 或直接串流寫入)
    // 此處簡化:最終一次性 save('php://output') 但已用磁碟緩存
}
$writer->save('php://output');

結語

Allowed memory size exhausted 是程式健康狀態的體檢報告。優先修復邏輯漏洞 (生成器、分批處理、及時釋放),輔以合理的 memory_limit 設定與監控體系。記住:記憶體是有限資源,演算法決定上限,工程決定下限。

copyright © 萬盛學電腦網 all rights reserved