生產環境中,因應應用相容性需求(如開發機為 MySQL 5.7,需將資料遷移至筆記本的 MySQL 5.5),直接使用 apt-get upgrade 可能面臨軟體源更新、系統依賴衝突等問題。本文記錄在 Ubuntu 14.04 上,透過官方 DEB 套件包手動離線升級 MySQL 5.5 → 5.7 的完整步驟與避坑指南。
mysqldump 完整備份所有資料庫(含結構、資料、觸發器、常式、事件)。
mysqldump -u root -p --all-databases --events --routines --triggers --single-transaction --master-data=2 > full_backup_$(date +%F).sql
service mysql stop
前往 MySQL 官方檔案庫:https://downloads.mysql.com/archives/community/
選擇:Ubuntu Linux 14.04 (Trusty)、MySQL 5.7、DEB Bundle。
本例下載:mysql-server_5.7.13-1ubuntu14.04_amd64.deb-bundle.tar
# 1. 解壓
tar -xvf mysql-server_5.7.13-1ubuntu14.04_amd64.deb-bundle.tar
# 2. 核心共用套件(必須最先安裝)
dpkg -i mysql-common_5.7.13-1ubuntu14.04_amd64.deb
dpkg -i libmysqlclient20_5.7.13-1ubuntu14.04_amd64.deb
dpkg -i libmysqlclient-dev_5.7.13-1ubuntu14.04_amd64.deb
dpkg -i libmysqld-dev_5.7.13-1ubuntu14.04_amd64.deb
# 3. 移除舊版 Client 避免衝突
apt-get remove mysql-client-5.5
# 4. 安裝新版 Client
dpkg -i mysql-community-client_5.7.13-1ubuntu14.04_amd64.deb
dpkg -i mysql-client_5.7.13-1ubuntu14.04_amd64.deb
# 5. 安裝 libmecab2 依賴(5.7 全文搜尋需求)
apt-get install libmecab2
# 此步驟會提示設定 MySQL root 密碼,請記錄
# 6. 安裝 Server 核心
dpkg -i mysql-community-server_5.7.13-1ubuntu14.04_amd64.deb
dpkg -i mysql-server_5.7.13-1ubuntu14.04_amd64.deb
> ⚠️ **重要提醒**:安裝順序不可亂動。`mysql-common` 必須最先升級,`libmysqlclient20` 為核心庫,Client 必須在 Server 之前升級,否則會發生依賴地獄。
mysql -V
# 輸出: mysql Ver 14.14 Distrib 5.7.13, for Linux (x86_64)
service mysql start
tail -f /var/log/mysql/error.log
mysql_upgrade -u root -p
# 檢查並修復系統表、資料表相容性
mysql -u root -p < full_backup_2023-10-01.sql
若原備份來自 5.7,直接匯入 5.5 會因語法不相容失敗(如 5.7 的 `CREATE TABLE ... ENCRYPTION='Y'`)。升級至 5.7 後即可完美匯入。
開發環境 MySQL 5.7 使用 mysqldump 匯出 SQL,嘗試導入筆記本的 MySQL 5.5 時失敗。錯誤原因:
utf8mb4,5.5 需顯式指定。JSON 資料型別,5.5 無法識別。結論: 跨大版本遷移,目標版本應 ≥ 來源版本,或使用相容模式導出(--compatible=mysql55),但最穩妥是統一版本。
| 問題 | 解決方案 |
|---|---|
| dpkg 依賴錯誤 | 嚴格遵循本文安裝順序;使用 apt-get -f install 修復缺失依賴 |
| root 密碼重置/遺忘 | 啟動 mysqld_safe --skip-grant-tables 重設密碼 |
| 啟動失敗 | 檢查 /var/log/mysql/error.log;常見原因:innodb_log_file_size 設定不匹配舊日誌檔案,刪除 /var/lib/mysql/ib_logfile* 重啟 |
| 字元集亂碼 | 確認 my.cnf 設定 character-set-server=utf8mb4,資料庫/表/連線字元集一致 |
手動透過 DEB 套件升級 MySQL 雖步驟繁瑣,但能完全掌控版本與依賴,避免系統自動更新帶來的不可控風險。核心成功要素:
mysql_upgrade 修復系統表此方法同樣適用於 MySQL 5.6 → 5.7、5.7 → 8.0 等大版本升級,只需替換對應版本的 DEB Bundle 即可。