2006: MySQL server has gone away
# 或
2013: Lost connection to MySQL server during query
典型場景:PHP/Java 應用插入大字段(BLOB/TEXT/長 JSON)時發生。
max_allowed_packet 控制 MySQL 客戶端/服務端通信緩衝區最大值。默認值:
當 SQL 語句大小超過此值,服務端直接斷開連接,客戶端收到「server has gone away」。
# /etc/my.cnf
[mysqld]
max_allowed_packet = 256M # 根據最大業務對象調整,建議 64M-512M
[client]
max_allowed_packet = 256M # 客戶端也需同步調整
[mysqldump]
max_allowed_packet = 256M # 備份工具同步調整
重啟生效:systemctl restart mysqld
mysql> SET GLOBAL max_allowed_packet = 268435456; -- 256M (字節單位)
mysql> SHOW VARIABLES LIKE 'max_allowed_packet';
⚠️ 重啟後失效,必須配合配置文件修改。
mysql> SET SESSION max_allowed_packet = 268435456;
| 屬性 | 說明 |
|---|---|
| 單位 | 字節 (bytes),配置文件支持 K/M/G 後綴 |
| 範圍 | 1024 bytes ~ 1GB (協議限制) |
| 對齊 | 必須是 1024 的倍數,否則自動向下取整 |
| 作用範圍 | 單個數據包最大長度,影響:INSERT/UPDATE 大字段、LOAD DATA、REPLICATION、mysqldump |
| 內存分配 | 非啟動時分配,而是按需動態擴展至上限 |
服務端調大後,客戶端必須同步調整,否則客戶端發送大包時會被自身限制截斷。
| 客戶端 | 配置方式 |
|---|---|
| MySQL 命令行 | mysql --max_allowed_packet=256M 或 [client] max_allowed_packet=256M |
| mysqldump | mysqldump --max_allowed_packet=256M |
| PHP PDO | PDO::MYSQL_ATTR_MAX_BUFFER_SIZE => 268435456 |
| Java JDBC | maxAllowedPacket=268435456 連接參數或 setMaxAllowedPacket() |
| Python PyMySQL | max_allowed_packet=268435456 連接參數 |
| 原因 | 特徵 | 排查/解決 |
|---|---|---|
| wait_timeout/interactive_timeout 過短 | 長連接閒置超時斷開 | 調大 timeout、啟用連接池驗證、心跳機制 |
| SQL 執行時間過長 | 大事務、無索引全表掃描 | 優化 SQL、拆分大事務、調大 net_read_timeout/net_write_timeout |
| 主庫重啟/主從切換 | 連接被強制斷開 | 應用層實現重連邏輯、使用 ProxySQL |
| OOM Killer 殺死進程 | 系統日志 Out of memory | 調小 buffer_pool、增加物理內存、配置 Swap |
| 網絡中斷/防火牆超時 | 間歇性、特定時間段 | 檢查網絡、調整防火牆/NAT 超時、TCP keepalive |
# 1. 測試大包插入
mysql -u root -p --max_allowed_packet=256M -e "
USE test;
CREATE TABLE t (data LONGBLOB);
INSERT INTO t SELECT REPEAT('x', 100*1024*1024); -- 100MB
"
# 2. 測試 mysqldump 大表導出
mysqldump --max_allowed_packet=256M -u root -p test t | gzip > /tmp/test.sql.gz
# 3. 應用層壓測
# 模擬業務大對象寫入,持續 30 分鐘觀察錯誤率
max_allowed_packet = 256M(現代應用常見 JSON/BLOB 較大)Max_used_connections、Aborted_clients 指標