PHP 長運行腳本中循環執行 SELECT,間隔超過 MySQL wait_timeout(默認 28800 秒 / 8 小時,部分環境 30 秒),導致連接被 Server 主動斷開,再次查詢拋出:
General error: 2006 MySQL server has gone away
The SQL statement executed was: SELECT * FROM ...
MySQL 服務端維護 wait_timeout(非交互式)與 interactive_timeout(交互式)兩個閾值。長連接閒置超過閾值,Server 切斷 TCP 連接,Client 端持有的連接句柄失效,後續操作即報 2006。
| 原因 | 排查命令 | 現象確認 |
|---|---|---|
| 1. 連接閒置超時 | SHOW GLOBAL VARIABLES LIKE '%timeout%'; | wait_timeout 較小(如 30s),長腳本間隔超過該值 |
| 2. MySQL 服務重啟/崩潰 | mysql -e "SHOW GLOBAL STATUS LIKE 'Uptime';"tail /var/log/mysql/error.log | Uptime 很小、錯誤日誌有啟動記錄 |
| 3. 連接被主動 KILL | mysql -e "SHOW GLOBAL STATUS LIKE 'Com_kill';" | Com_kill 計數增長,常見於 DBA 手動 kill 慢查詢 |
| 4. 數據包超過 max_allowed_packet | SHOW GLOBAL VARIABLES LIKE 'max_allowed_packet'; | 單條 SQL/結果集 > 1MB(默認),需調大至 16MB+ |
使用 mysqli_ping() 或 PDO ATTR_AUTOCOMMIT 機制,執行查詢前主動檢測連接存活,失效則重連。
<?php
class MySQL {
private $link;
public function connect() {
$this->link = mysqli_connect('localhost', 'root', '123456', 'dbname');
}
public function ping() {
if (!mysqli_ping($this->link)) {
mysqli_close($this->link); // 關鍵:先關閉失效句柄
$this->connect();
}
}
public function query($sql) {
$this->ping(); // 每次查詢前心跳
return mysqli_query($this->link, $sql);
}
}
-- 臨時生效
SET GLOBAL wait_timeout = 28800;
SET GLOBAL interactive_timeout = 28800;
-- 永久生效:編輯 my.cnf [mysqld]
wait_timeout = 28800
interactive_timeout = 28800
注意:過大導致閒置連接佔用資源,需配合連接池 max_connections、max_user_connections 綜合評估。
SET GLOBAL max_allowed_packet = 16777216; -- 16MB
-- my.cnf 永久
max_allowed_packet = 16M
testWhileIdle、validationQuery(SELECT 1)、timeBetweenEvictionRunsMillisvalidationQueryTimeout < wait_timeoutwait_timeout ≥ 業務最長閒置間隔Aborted_clients、Aborted_connects 指標,異常增長即告警log_error,保留足夠天數便於事後分析