上傳帶圖片的大文件時拋出 MySQL server has gone away,但小文件正常。排查發現 wait_timeout 設置過小導致連接過早斷開。
wait_timeout:非交互式連接(如應用程式連接池)空閒超過此秒數,MySQL 主動斷開interactive_timeout:交互式連接(如命令行客戶端、GUI 工具)空閒斷開閾值my.cnf/my.ini[mysqld]
wait_timeout = 300
interactive_timeout = 300
SET GLOBAL wait_timeout = 300;
SET GLOBAL interactive_timeout = 300;
配合配置文件修改,實現即時生效與持久化雙保障。
| 設置策略 | 優點 | 風險 | 適用場景 |
|---|---|---|---|
| 過小(<60s) | 快速釋放殭屍連接 | 長事務/大文件傳輸斷連、連接池頻繁重建 | 極短連接、高併發短查詢 |
| 適中(300-3600s) | 平衡資源釋放與業務容錯 | 需配合連接池心跳(testOnBorrow/idleTimeout) | 大多數 Web 應用推薦 |
| 過大(>8h) | 幾乎不斷連 | SHOW PROCESSLIST 積累大量 Sleep 連接,易觸發 max_connections 限制 | 長連接批處理、ETL 作業 |
網上流傳
wait_timeout=2880000(33天)屬於不負責任配置:極大浪費連接槽位,掩蓋應用層連接洩漏 Bug,最終導致too many connections。
idleTimeout < wait_timeout(建議 30s-5min),maxLifetime 略小於 wait_timeoutpool_recycle=wait_timeout - 60SetConnMaxLifetime(time.Duration(wait_timeout-60)*time.Second)核心原則:應用層主動回收連接的時間 必須早於 MySQL 被動斷開時間。
mysql> SHOW VARIABLES LIKE 'wait_timeout';
mysql> SHOW VARIABLES LIKE 'interactive_timeout';
-- 或查看當前會話值
mysql> SHOW SESSION VARIABLES LIKE '%timeout';
wait_timeout 過小是大文件上傳、長事務報 server has gone away 的元兇。設定 300-3600 秒、配合連接池心跳機制、拒絕「一勞永逸」式超大值,是穩健的生產環境配置策略。記住:應用層主動管理連接生命週期,遠優於依賴資料庫被動踢人。