萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> MySQL 教學

解決 MySQL server has gone away 四大實戰方案

錯誤成因

MySQL server has gone away 通常因連線閒置超過 wait_timeout(預設 8 小時)、單次封包超過 max_allowed_packet、或服務端主動關閉連線(重啟、OOM Killer、主從切換)。

方案一:調大伺服器端超時參數

[mysqld]
wait_timeout = 28800          # 8 小時,視業務調大
interactive_timeout = 28800
max_allowed_packet = 64M      # 大欄位/批次寫入需調大

修改後 systemctl restart mysqld 生效。

方案二:客戶端連線時指定 CLIENT_INTERACTIVE

PHP (mysqli) 範例:

$mysqli = new mysqli('host', 'user', 'pass', 'db', 3306, NULL, MYSQLI_CLIENT_INTERACTIVE);
// 或
mysqli_real_connect($link, 'host', 'user', 'pass', 'db', 3306, NULL, MYSQLI_CLIENT_INTERACTIVE);

啟用後客戶端採用 interactive_timeout,通常較長。

方案三:應用層心跳重連(最推薦,可控性最強)

function db_ping(mysqli $link): void {
    if (!$link->ping()) {          // 檢測連線
        $link->close();            // 關鍵:必須先 close
        $link->real_connect(...);  // 重新連線
    }
}

// 使用時機:長時間任務(爬蟲、ETL)每批次前呼叫
$html = file_get_contents('https://example.com');
db_ping($mysqli);
$mysqli->query('SELECT * FROM table');

原理:mysqli::ping() 若偵測斷線會嘗試重連,但預設不自動重連;先 close() 再 real_connect() 能確保乾淨重建。

方案四:連線池與持久連線配置

  • PHP-FPM + mysqli.allow_persistent = On、mysqli.reconnect = On(php.ini)。
  • 框架層(Laravel/ThinkPHP)多內建重連邏輯,確認啟用即可。
  • Java/JDBC:autoReconnect=true、testOnBorrow=true、validationQuery=SELECT 1。

官方建議參數組合

[mysqld]
wait_timeout = 28800
interactive_timeout = 28800
max_allowed_packet = 32M

[client]
max_allowed_packet = 32M

排查清單

  1. 錯誤日誌是否有 Aborted connection、OOM、磁碟滿。
  2. 長時間批次任務是否加入心跳重連。
  3. 單次 SQL/批次大小是否超過 max_allowed_packet。
  4. 主從切換、備份鎖表是否導致主庫短暫不可用。
copyright © 萬盛學電腦網 all rights reserved