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 生效。
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() 能確保乾淨重建。
mysqli.allow_persistent = On、mysqli.reconnect = On(php.ini)。autoReconnect=true、testOnBorrow=true、validationQuery=SELECT 1。[mysqld]
wait_timeout = 28800
interactive_timeout = 28800
max_allowed_packet = 32M
[client]
max_allowed_packet = 32M
Aborted connection、OOM、磁碟滿。max_allowed_packet。