萬盛學電腦網

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

MySQL 版本升級遷坑指南:mysql.proc 錯誤與 mysqldump GTID_MODE 失效解決

升級後常見的兩大經典報錯

MySQL 大版本升級(如 5.1→5.5、5.5→5.6、5.7→8.0)常因系統表結構變更、新特性引入導致相容性問題。本文聚焦兩個高頻坑點及解法。

坑點一:mysql.proc 表結構不匹配 (Column count wrong)

錯誤現象

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

mysql_upgrade -u root -p --force
# 或指定目錄 (非常規安裝路徑)
mysql_upgrade -u root -p --datadir=/data/mysql --basedir=/usr/local/mysql

mysql_upgrade 會:

  1. 檢查所有表相容性並修復。
  2. 升級系統表結構 (mysql.proc, mysql.user 等)。
  3. 重建權限表、刷新權限。

執行後重啟 MySQL 服務即可恢復正常。

坑點二:mysqldump 5.6+ 備份 5.5/5.1 報 Unknown system variable 'GTID_MODE'

錯誤現象

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 完全沒有此變數,導致崩潰。

解法:強制關閉 GTID 模式檢測

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.05.6+ (GTID 啟用)否 (自動檢測)
5.6 / 5.7 / 8.05.6+ (GTID 未啟用)建議加 AUTO (預設)
5.6 / 5.7 / 8.05.5 / 5.1 / 更舊必須加 OFF

遷移最佳實踐清單

  1. 先升級客戶端工具:確保 mysqldump/mysql 客戶端版本 ≥ 目標 Server 版本。
  2. 導出前加參數:跨大版本導出務必加 --set-gtid-purged=OFF。
  3. 導入後跑升級:導入資料後立即執行 mysql_upgrade。
  4. 驗證存儲過程/函數/觸發器/視圖:mysql_upgrade 會自動重建,但複雜邏輯建議人工複核。
  5. 測試應用相容性:SQL 模式 (sql_mode)、保留字、函數行為可能變更。

升級不怕難,怕在不按套路出牌。按圖索驥,穩穩落地。

copyright © 萬盛學電腦網 all rights reserved