解決 MySQL "server has gone away" 兩大有效方案：超時配置與連接存活檢測

MySQL "server has gone away" 根因與兩種徹底解決方案

錯誤提示 MySQL server has gone away（錯誤碼 2006），核心原因：**客戶端持有的連接在服務端已被關閉**，再次使用時發現失效。

一、核心成因分析

1. 連接超時：服務端 wait_timeout（默認 8 小時）或 interactive_timeout 到期，主動斷開空閒連接
2. 數據包過大：SQL/結果集超過 max_allowed_packet（默認 4MB/64MB）
3. 服務端重啟/崩潰：連接隨進程消失
4. 主動 KILL：DBA 或自動化腳本殺死長事務/慢查詢

二、方案一：調大超時參數（治標）

# my.cnf [mysqld]
wait_timeout = 28800          # 8小時，非交互連接
interactive_timeout = 28800   # 交互連接
max_allowed_packet = 64M      # 防大包斷開

# 會話級臨時調整
SET SESSION wait_timeout = 86400;  -- 24小時
SET SESSION max_allowed_packet = 1073741824;  -- 1GB

適用：長連接池、批處理任務、低頻訪問應用。缺點：佔用服務端連接資源，掩蓋應用層連接管理缺陷。

三、方案二：連接存活檢測與自動重連（治本，推薦）

原理

應用層在關鍵操作前主動探測連接可用性，失效則重建。MySQL C API 提供 mysql_ping() + MYSQL_OPT_RECONNECT，但各語言驅動實現不同。

PHP (mysqli) 正確姿勢

class MySQLiWrapper {
    private $mysqli;
    
    public function __construct($host, $user, $pass, $db) {
        $this->mysqli = new mysqli($host, $user, $pass, $db);
        // 關鍵：啟用自動重連（需 PHP 5.3+）
        $this->mysqli->options(MYSQLI_OPT_RECONNECT, true);
    }
    
    public function ping() {
        if (!$this->mysqli->ping()) {
            // ping 失敗時，mysqli 已嘗試重連
            // 但最保險：顯式關閉重建
            $this->mysqli->close();
            $this->mysqli = new mysqli($host, $user, $pass, $db);
            $this->mysqli->options(MYSQLI_OPT_RECONNECT, true);
        }
    }
    
    public function query($sql) {
        $this->ping();  // 每次查詢前探測
        return $this->mysqli->query($sql);
    }
}

// 使用示例
$db = new MySQLiWrapper('127.0.0.1', 'root', 'pass', 'db');
$content = file_get_contents('https://slow-site.com');  // 耗時操作
$db->query("INSERT INTO logs (content) VALUES ('$content')");  // 自動重連

Python (PyMySQL/ mysqlclient) 池化方案

import pymysql
from DBUtils.PooledDB import PooledDB

pool = PooledDB(
    creator=pymysql,
    maxconnections=20,
    host='127.0.0.1', user='root', password='pass', database='db',
    charset='utf8mb4',
    # 關鍵：獲取連接前自動 ping
    ping=1,  # 1=每次獲取 ping, 7=每次歸還 ping
    setsession=['SET SESSION wait_timeout=86400']
)

conn = pool.connection()
cursor = conn.cursor()
cursor.execute("SELECT 1")  # 連接池自動處理失效連接

Java (HikariCP + MySQL Connector/J) 最佳實踐

HikariConfig config = new HikariConfig();
config.setJdbcUrl("jdbc:mysql://127.0.0.1:3306/db?useUnicode=true&characterEncoding=utf8mb4");
config.setUsername("root");
config.setPassword("pass");
// 連接池級別存活檢測
config.setConnectionTestQuery("SELECT 1");
config.setMinimumIdle(5);
config.setMaximumPoolSize(20);
config.setIdleTimeout(300000);      // 5分鐘空閒回收
config.setMaxLifetime(1800000);     // 30分鐘強制換新
config.setConnectionTimeout(30000);
config.addDataSourceProperty("cachePrepStmts", "true");
config.addDataSourceProperty("prepStmtCacheSize", "250");
config.addDataSourceProperty("prepStmtCacheSqlLimit", "2048");

HikariDataSource ds = new HikariDataSource(config);
// 獲取連接自動驗證，失效自動重建

四、方案對比與選擇建議

核心原則：不要依賴長連接永久存活。使用成熟連接池（HikariCP、DBUtils、node-mysql2 等），配置 connectionTestQuery/ping/validationQuery，設置合理 maxLifetime < wait_timeout，實現「借用即驗證、超時即回收、失效即重建」。