MySQL 大版本升級(如 5.1→5.5、5.5→5.6、5.7→8.0)常因系統表結構變更、新特性引入導致相容性問題。本文聚焦兩個高頻坑點及解法。
ERROR 1558 (HY000): Column count of mysql.proc is wrong. Expected 20, found 16.
Created with MySQL 50018, now running 50146.
Please use mysql_upgrade to fix this error.
直接複製 data 目錄遷移資料,導致系統表 mysql.proc(存儲存儲過程/函數元數據)結構舊版,與新版 MySQL 期望不符。
mysql_upgrade -u root -p --force
# 或指定目錄 (非常規安裝路徑)
mysql_upgrade -u root -p --datadir=/data/mysql --basedir=/usr/local/mysql
mysql_upgrade 會:
mysql.proc, mysql.user 等)。執行後重啟 MySQL 服務即可恢復正常。
mysqldump: Couldn't execute 'SELECT @@GTID_MODE': Unknown system variable 'GTID_MODE' (1193)
MySQL 5.6.5 引入 GTID 複製。mysqldump 5.6+ 預設嘗試查詢 @@GTID_MODE 以決定是否包含 GTID 資訊,但 5.5/5.1 完全沒有此變數,導致崩潰。
mysqldump --set-gtid-purged=OFF -u root -p --single-transaction db_name > backup.sql
參數說明:
--set-gtid-purged=OFF:不嘗試讀取 GTID 狀態,直接按傳統模式導出。--single-transaction:InnoDB 熱備份必備,保證一致性無鎖表。| mysqldump 版本 | 目標 Server 版本 | 是否需加參數 |
|---|---|---|
| 5.6 / 5.7 / 8.0 | 5.6+ (GTID 啟用) | 否 (自動檢測) |
| 5.6 / 5.7 / 8.0 | 5.6+ (GTID 未啟用) | 建議加 AUTO (預設) |
| 5.6 / 5.7 / 8.0 | 5.5 / 5.1 / 更舊 | 必須加 OFF |
mysqldump/mysql 客戶端版本 ≥ 目標 Server 版本。--set-gtid-purged=OFF。mysql_upgrade。mysql_upgrade 會自動重建,但複雜邏輯建議人工複核。sql_mode)、保留字、函數行為可能變更。升級不怕難,怕在不按套路出牌。按圖索驥,穩穩落地。