MariaDB 服務故障排除指南

MariaDB 是一個開源的關聯式資料庫管理系統，廣泛應用於各種應用場景中。儘管 MariaDB 通常運行穩定，但在某些情況下，您可能會遇到服務故障或性能問題。本文將詳細介紹如何在 ServBay 中對 MariaDB 服務進行故障排除，包括常見問題、診斷步驟和解決方案。ServBay 運行在 macOS 作業系統上，並且自帶了不同版本的 MariaDB，所以在一些指令中，需要指定版本特定的配置文件和目錄。

常見問題及解決方案

1. MariaDB 服務無法啟動

可能原因

• 配置文件錯誤
• 端口被佔用
• 權限問題

解決方案

1. 檢查配置文件： 確保配置文件 my.cnf 語法正確，路徑為：

   /Applications/ServBay/etc/mariadb/11.3/my.cnf

   使用以下命令驗證配置文件：

   mysqld --defaults-file=/Applications/ServBay/etc/mariadb/11.3/my.cnf --validate-config

2. 檢查端口佔用： 確保 MariaDB 使用的端口（預設 3306）未被其他進程佔用。使用以下命令檢查端口佔用情況：

   lsof -i :3306

3. 檢查權限： 確保 MariaDB 數據目錄和配置文件的權限正確。使用以下命令檢查權限：

   ls -l /Applications/ServBay/db/mariadb/11.3
   ls -l /Applications/ServBay/etc/mariadb/11.3/my.cnf

4. 啟動服務： 嘗試重新啟動 MariaDB 服務：

   servbayctl restart mariadb 11.3

2. 無法連接到 MariaDB

可能原因

• MariaDB 服務未運行
• 防火牆阻止連接
• 使用者權限問題

解決方案

1. 檢查服務狀態： 確保 MariaDB 服務正在運行：

   servbayctl status mariadb 11.3

2. 檢查防火牆設置： 確保防火牆允許 MariaDB 的端口（預設 3306）通過：

   sudo /usr/libexec/ApplicationFirewall/socketfilterfw --add /Applications/ServBay/bin/mysqld
   sudo /usr/libexec/ApplicationFirewall/socketfilterfw --unblockapp /Applications/ServBay/bin/mysqld

3. 檢查使用者權限： 確保使用者有足夠的權限連接到資料庫：

   SHOW GRANTS FOR 'your_username'@'localhost';

4. 連接測試： 使用以下命令測試連接：

   mysql --defaults-file=/Applications/ServBay/etc/mariadb/11.3/my.cnf -u your_username -p -h localhost -P 3306

3. 性能問題

可能原因

• 查詢未優化
• 緩存配置不當
• 索引缺失

解決方案

1. 優化查詢： 使用 EXPLAIN 剖析查詢性能，並進行相應優化：

   EXPLAIN SELECT * FROM your_table_name WHERE column_name = 'value';

2. 調整緩存： 調整 my.cnf 中的緩存設置，例如：

   [mysqld]
   query_cache_size = 64M
   innodb_buffer_pool_size = 1G

3. 創建索引： 確保常用查詢的列已建立索引：

   CREATE INDEX idx_column_name ON your_table_name(column_name);

4. 資料庫崩潰

可能原因

• 硬體故障
• 軟體衝突
• 配置錯誤

解決方案

1. 檢查錯誤日誌： 查看 MariaDB 錯誤日誌，找到崩潰的具體原因。錯誤日誌路徑為：

   /Applications/ServBay/logs/mariadb/11.3.err

2. 修復資料庫： 使用 mysqlcheck 工具修復資料庫：

   mysqlcheck --defaults-file=/Applications/ServBay/etc/mariadb/11.3/my.cnf -u your_username -p --auto-repair --all-databases

3. 恢復數據： 如果資料庫文件損壞，可以從備份中恢復數據。備份文件路徑為：

   /Applications/ServBay/backup/mariadb/11.3

5. 備份和恢復問題

可能原因

• 備份文件損壞
• 恢復命令錯誤

解決方案

1. 檢查備份文件： 確保備份文件完整且未損壞。使用以下命令檢查備份文件大小和完整性：

   ls -lh /Applications/ServBay/backup/mariadb/11.3/your_backup.sql

2. 正確恢復資料庫： 使用 mysql 工具正確恢復資料庫：

   mysql --defaults-file=/Applications/ServBay/etc/mariadb/11.3/my.cnf -u your_username -p your_database < /Applications/ServBay/backup/mariadb/11.3/your_backup.sql

特定問題：ib_logfile0 was not found 和 InnoDB: Missing FILE_CHECKPOINT(47594) at 47594

可能原因

• MariaDB 11.5.1的bug

錯誤日誌

240618 22:37:46 mysqld_safe Starting mariadbd daemon with databases from /Applications/ServBay/db/mariadb/11.5
2024-06-18 22:37:46 0 [Note] Starting MariaDB 11.5.1-MariaDB-log source revision 65079ece42f383bdeb9b3f913a833a6f0123919d as process 3323
2024-06-18 22:37:46 0 [Warning] Setting lower_case_table_names=2 because file system for /Applications/ServBay/db/mariadb/11.5/ is case insensitive
2024-06-18 22:37:47 0 [Warning] --innodb-file-per-table is deprecated and will be removed in a future release
2024-06-18 22:37:47 0 [Note] InnoDB: Compressed tables use zlib 1.3.1
2024-06-18 22:37:47 0 [Note] InnoDB: Number of transaction pools: 1
2024-06-18 22:37:47 0 [Note] InnoDB: Using crc32 + pclmulqdq instructions
2024-06-18 22:37:47 0 [Note] InnoDB: Initializing buffer pool, total size = 4.000GiB, chunk size = 64.000MiB
2024-06-18 22:37:47 0 [Note] InnoDB: Completed initialization of buffer pool
2024-06-18 22:37:47 0 [ERROR] InnoDB: File /Applications/ServBay/db/mariadb/11.5/ib_logfile0 was not found
2024-06-18 22:37:47 0 [ERROR] InnoDB: Plugin initialization aborted with error Generic error
2024-06-18 22:37:47 0 [Note] InnoDB: Starting shutdown...
2024-06-18 22:37:47 0 [ERROR] Plugin 'InnoDB' registration as a STORAGE ENGINE failed.
2024-06-18 22:37:47 0 [Note] Plugin 'FEEDBACK' is disabled.
2024-06-18 22:37:47 0 [Note] Plugin 'wsrep-provider' is disabled.
2024-06-18 22:37:47 0 [ERROR] Unknown/unsupported storage engine: InnoDB
2024-06-18 22:37:47 0 [ERROR] Aborting
240618 22:37:48 mysqld_safe mysqld from pid file /Applications/ServBay/tmp/mariadb-11.5.pid ended

240618 23:22:28 mysqld_safe Starting mariadbd daemon with databases from /Applications/ServBay/db/mariadb/11.5
2024-06-18 23:22:28 0 [Note] Starting MariaDB 11.5.1-MariaDB-log source revision 65079ece42f383bdeb9b3f913a833a6f0123919d as process 6667
2024-06-18 23:22:28 0 [Warning] Setting lower_case_table_names=2 because file system for /Applications/ServBay/db/mariadb/11.5/ is case insensitive
2024-06-18 23:22:29 0 [Warning] --innodb-file-per-table is deprecated and will be removed in a future release
2024-06-18 23:22:29 0 [Note] InnoDB: Compressed tables use zlib 1.3.1
2024-06-18 23:22:29 0 [Note] InnoDB: Number of transaction pools: 1
2024-06-18 23:22:29 0 [Note] InnoDB: Using crc32 + pclmulqdq instructions
2024-06-18 23:22:29 0 [Note] InnoDB: Initializing buffer pool, total size = 4.000GiB, chunk size = 64.000MiB
2024-06-18 23:22:29 0 [Note] InnoDB: Completed initialization of buffer pool
2024-06-18 23:22:29 0 [ERROR] InnoDB: Missing FILE_CHECKPOINT(47594) at 47594
2024-06-18 23:22:29 0 [ERROR] InnoDB: Log scan aborted at LSN 47594
2024-06-18 23:22:29 0 [ERROR] InnoDB: Plugin initialization aborted with error Generic error
2024-06-18 23:22:29 0 [Note] InnoDB: Starting shutdown...
2024-06-18 23:22:29 0 [ERROR] Plugin 'InnoDB' registration as a STORAGE ENGINE failed.
2024-06-18 23:22:29 0 [Note] Plugin 'FEEDBACK' is disabled.
2024-06-18 23:22:29 0 [Note] Plugin 'wsrep-provider' is disabled.
2024-06-18 23:22:29 0 [ERROR] Unknown/unsupported storage engine: InnoDB
2024-06-18 23:22:29 0 [ERROR] Aborting
240618 23:22:29 mysqld_safe mysqld from pid file /Applications/ServBay/tmp/mariadb-11.5.pid ended

解決方案

參考文章 修改MariaDB設置，找到 my.cnf，然後按以下詳細步驟操作：

1. 在 my.cnf 中[mysqld]段後添加 innodb_force_recovery = 6

   編輯配置文件 my.cnf，找到[mysqld]，添加以下行：

   innodb_force_recovery = 6

2. 啟動 MariaDB

   使用以下命令啟動 MariaDB：

   servbayctl start mariadb 11.5

3. 備份 MariaDB

   使用 mysqldump 命令備份所有資料庫：

   mysqldump -uroot -p --all-databases --opt > /Applications/ServBay/backup/mariadb/11.5/mariadb_backup.sql

4. 禁用 MariaDB 服務

   在ServBay的管理面板中，禁用MariaDB 11.5服务

5. 從 my.cnf 中删除 innodb_force_recovery = 6

   編輯配置文件 my.cnf，刪除以下行：

   innodb_force_recovery = 6

6. 重命名 11.5 目錄

   將 MariaDB 數據目錄 11.5 重命名為 11.5.bak：

   mv /Applications/ServBay/db/mariadb/11.5 /Applications/ServBay/db/mariadb/11.5.bak

7. 更換其他版本的 MariaDB

   更換回沒有問題的MariaDB 11.5.0，或者其他版本，比如11.3、11.4。

8. 恢復 MariaDB 備份

   使用 mysql 命令恢復資料庫：

   mysql -uroot -p < /Applications/ServBay/backup/mariadb/11.5/mariadb_backup.sql

總結

MariaDB 是一個強大且靈活的資料庫管理系統，但在使用過程中可能會遇到各種問題。通過本文的介紹，您可以了解如何對 MariaDB 服務進行故障排除，包括常見問題的診斷和解決方案。希望本文對您有所幫助，如果您有任何問題或需要進一步的幫助，請隨時與我們联系。