萬盛學電腦網

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

MySQL 5.5 升級 5.6 後 GRANT 報錯 ERROR 2013 解決:缺失 mysql_upgrade 步驟

故障現象

原地升級 MySQL 5.5 → 5.6(直接替換二進制、復用 datadir)後,服務正常啟動,但執行 GRANT 語句報錯:

mysql> GRANT ALL ON new_db.* TO 'user'@'%';
ERROR 2013 (HY000): Lost connection to MySQL server during query

伴隨錯誤日志:

Can't connect to local MySQL server through socket '/var/lib/mysql/mysql.sock'

根因分析

MySQL 版本升級時,系統表結構會變更(新增權限列、修改列類型、調整索引)。直接啟動新版本對舊系統表操作,導致:

  • 權限檢查邏輯與表結構不匹配
  • 查詢 mysql.user、mysql.db 等表時觸發崩潰/斷連
  • GTID、角色、密碼過期等新特性依賴的列缺失

標準解決方案:執行 mysql_upgrade

# 1. 確保 MySQL 服務正在運行
systemctl status mysqld

# 2. 執行升級腳本
mysql_upgrade -u root -p --force
# --force 強制檢查所有表,即使版本號一致

# 3. 輸出示例
Phase 1/7: Checking and upgrading mysql database
Processing databases
mysql.columns_priv                                 OK
mysql.db                                           OK
mysql.engine_cost                                  OK
mysql.event                                        OK
mysql.func                                         OK
mysql.general_log                                  OK
mysql.gtid_executed                                OK
mysql.help_category                                OK
...
Phase 2/7: Installing used storage engines... Skipped
Phase 3/7: Fixing views
Phase 4/7: Running 'mysql_fix_privilege_tables'
Phase 5/7: Fixing table and database names
Phase 6/7: Checking and upgrading tables
Phase 7/7: Flushing privileges
OK

mysql_upgrade 核心作用

  1. 檢查/修復所有表:執行 CHECK TABLE ... FOR UPGRADE,必要時 REPAIR TABLE
  2. 升級系統表結構:調整 mysql.user、mysql.db、mysql.tables_priv 等結構以匹配新版本
  3. 刷新權限緩存:FLUSH PRIVILEGES 使新結構生效
  4. 更新數據字典:MySQL 8.0 更新 DD(Data Dictionary)

關鍵注意事項

⚠️ 禁用場景:
--gtid-mode=ON 時 禁止 使用 mysql_upgrade!
因其會非事務性修改系統表(多為 MyISAM),導致 GTID 一致性破壞。
GTID 環境升級請參考官方文檔「GTID mode and mysql_upgrade」。

完整升級流程規範

# 1. 備份(核心原則)
mysqldump --all-databases --single-transaction --master-data=2 --routines --triggers --events > /backup/pre_upgrade_$(date +%F).sql

# 2. 停止服務
systemctl stop mysqld

# 3. 替換二進制 / 安裝新版本
# ... 安裝步驟 ...

# 4. 啟動新版本(暫不加載業務流量)
systemctl start mysqld

# 5. 執行升級腳本
mysql_upgrade -u root -p --force

# 6. 重啟確保所有緩存刷新
systemctl restart mysqld

# 7. 驗證
mysql -u root -p -e "SELECT VERSION(); SHOW GRANTS FOR 'root'@'localhost';"
mysql -u root -p -e "GRANT SELECT ON test.* TO 'test_user'@'%';"  # 原報錯操作驗證

# 8. 恢復業務流量

MySQL 8.0 升級特殊說明

  • 8.0 移除了 mysql_upgrade,升級邏輯整合到服務啟動過程(--upgrade=FORCE)
  • 數據字典 (DD) 取代了 frm/系統表,升級過程自動遷移
  • 不可跳版本升級:5.7 → 8.0 必須先 5.7 最後一個 GA 版本
  • 升級前必須運行 MySQL Shell 升級檢查工具:util.checkForServerUpgrade()

故障排查:執行 mysql_upgrade 仍報錯

  1. 檢查錯誤日志:tail -100 /var/log/mysqld.log
  2. 確認磁盤空間:df -h /data/mysql
  3. 檢查權限:ls -la /data/mysql/ 確保 mysql 用戶可讀寫
  4. 嘗試單表修復:mysqlcheck --auto-repair -u root -p mysql
  5. 極端情況:從備份恢復系統表數據
copyright © 萬盛學電腦網 all rights reserved