解決 MySQL "server has gone away" 完整排查指南

錯誤現象

應用程式（如 PHP 批次腳本、圖片資料處理）執行長時間或大型 SQL 時，MySQL 突然斷開連線，拋出 MySQL server has gone away（錯誤碼 2006）。

兩大核心成因與解決方案

成因一：SQL 封包超過 max_allowed_packet

典型場景：超長 SQL、含 BLOB/LONGBLOB 欄位（如圖片二進制）、大批次 INSERT。

解決：調大 my.cnf 參數：

[mysqld]
max_allowed_packet = 64M  # 視實際需求調整，建議 16M-256M

重啟 MySQL 生效。原理：此參數控制通訊緩衝區上限，客戶端與伺服端均需足夠大。

成因二：連線閒置超時 wait_timeout

典型場景：應用使用連線池/單例模式，兩次 DB 操作間隔超過 wait_timeout（預設 8 小時 = 28800 秒），MySQL 主動斷開閒置連線，應用重用失效連線時報錯。

驗證：SHOW VARIABLES LIKE 'wait_timeout';

方案 A：調大伺服端超時（治標）

[mysqld]
wait_timeout = 2880000
interactive_timeout = 2880000

方案 B：客戶端心跳保活（治本，推薦）

程式碼層面定期執行 mysql_ping() 或輕量查詢（如 SELECT 1），維持連線活躍。

方案 C：連線層面設定互動超時（不改配置檔）

-- 連線建立後立即執行
SET SESSION interactive_timeout = 86400;  -- 24小時

最佳實踐：連線池配置 testOnBorrow=true + validationQuery=SELECT 1，借用連線前自動驗證，失效則重建。

其他潛在成因快速排查

PHP 專屬建議

• 使用 mysqli 或 PDO 替代已棄用的 mysql 擴展
• PDO 設定：PDO::ATTR_PERSISTENT => false（避免持久連線超時坑）+ PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION
• 長跑腳本：set_time_limit(0) + 分批提交 + 定期 $pdo->query('SELECT 1') 心跳