萬盛學電腦網

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

MySQL「General error 2006: MySQL server has gone away」錯誤根因分析與四大解決方案

錯誤場景回顧

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. 連接被主動 KILLmysql -e "SHOW GLOBAL STATUS LIKE 'Com_kill';"Com_kill 計數增長,常見於 DBA 手動 kill 慢查詢
4. 數據包超過 max_allowed_packetSHOW 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);
    }
}

方案二:調大 Server 端超時參數

-- 臨時生效
SET GLOBAL wait_timeout = 28800;
SET GLOBAL interactive_timeout = 28800;

-- 永久生效:編輯 my.cnf [mysqld]
wait_timeout = 28800
interactive_timeout = 28800

注意:過大導致閒置連接佔用資源,需配合連接池 max_connections、max_user_connections 綜合評估。

方案三:調大 max_allowed_packet

SET GLOBAL max_allowed_packet = 16777216; -- 16MB
-- my.cnf 永久
max_allowed_packet = 16M

方案四:連接池配置驗證機制

  • HikariCP / Druid / DBCP 等連接池內建 testWhileIdle、validationQuery(SELECT 1)、timeBetweenEvictionRunsMillis
  • 確保 validationQueryTimeout < wait_timeout

生產環境檢查清單

  1. 確認 wait_timeout ≥ 業務最長閒置間隔
  2. 啟用連接池驗證查詢,定期清理失效連接
  3. 監控 Aborted_clients、Aborted_connects 指標,異常增長即告警
  4. 錯誤日誌配置 log_error,保留足夠天數便於事後分析
copyright © 萬盛學電腦網 all rights reserved