萬盛學電腦網

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

MySQL 啟動失敗「Plugin 'InnoDB' registration as a STORAGE ENGINE failed」根因與修復

錯誤日誌原文

Plugin 'InnoDB' registration as a STORAGE ENGINE failed.

事件 ID 100,來源 MySQL,典型出現在 **更換 my.ini/my.cnf 後重啟**。

根因:殘留 Redo Log 檔案(ib_logfile*)與新配置不匹配

  • InnoDB 啟動時會讀取 innodb_log_file_size、innodb_log_files_in_group 等參數。
  • 若磁碟上現有的 ib_logfile0, ib_logfile1... **大小/數量與配置不一致**,InnoDB 拒絕啟動並報上述錯誤。
  • 常見觸發場景:調大 innodb_log_file_size、調整 innodb_log_files_in_group、遷移 datadir 但舊 log 檔殘留。

修復步驟(Windows / Linux 通用)

步驟 1:停止 MySQL 服務

# Windows
net stop mysql
# 或 services.msc 停止 MySQL 服務

# Linux
systemctl stop mysqld
# 或 service mysqld stop

步驟 2:定位並刪除舊 Redo Log 檔案

# Windows (預設 datadir)
del "C:\ProgramData\MySQL\MySQL Server 5.7\Data\ib_logfile*"
# 或依實際 datadir 路徑

# Linux
rm -f /var/lib/mysql/ib_logfile*
# 或依 my.cnf datadir 設定

步驟 3:啟動 MySQL

# Windows
net start mysql

# Linux
systemctl start mysqld

InnoDB 會依新配置**重新建立**對應大小/數量的 ib_logfile*,啟動成功。

為什麼不能直接覆蓋?

InnoDB 為保證崩潰恢復正確性,**嚴格檢查**啟動參數與磁碟上 redo log 檔案的一致性。任何不匹配(大小、數量、校驗和)都會導致啟動中止,防止資料損壞。

預防最佳實踐

  1. 修改 innodb_log_file_size / innodb_log_files_in_group 時,務必按上述三步驟操作。
  2. 生產環境變更前,**完整備份**(xtrabackup 或 mysqldump)。
  3. 變更後觀察錯誤日誌前 50 行,確認 InnoDB: Log file ... new log files created 訊息。
  4. 若使用 innodb_fast_shutdown=0 關機,可加速下次啟動恢復(但關機較慢)。

擴展:其他導致相同錯誤的原因

原因檢查方式處理
innodb_buffer_pool_size` > 實體記憶體錯誤日誌含 Cannot allocate memory調小 buffer pool
datadir` 路徑錯誤/無權限ls -ld datadir、chown mysql:mysql修正路徑與權限
舊版插件庫不相容升級 MySQL 後未執行 mysql_upgrade執行 mysql_upgrade -u root -p
SELinux/AppArmor 阻擋audit.log 有 AVC denial調整策略或暫時關閉驗證

驗證 InnoDB 正常載入

mysql -e "SHOW ENGINES\G" | grep -A5 InnoDB
-- Support: YES
-- Comment: Supports transactions, row-level locking, foreign keys
copyright © 萬盛學電腦網 all rights reserved