MariaDB 服務故障排除指南

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

常見問題及解決方案

1. MariaDB 服務無法啟動

可能原因

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

解決方案

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

bash

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

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

bash

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

檢查端口佔用：確保 MariaDB 使用的端口（預設 3306）未被其他進程佔用。使用以下命令檢查端口佔用情況：
bash
```
lsof -i :3306
```
1
檢查權限：確保 MariaDB 數據目錄和配置文件的權限正確。使用以下命令檢查權限：
bash
```
ls -l /Applications/ServBay/db/mariadb/11.3
ls -l /Applications/ServBay/etc/mariadb/11.3/my.cnf
```
1
2
啟動服務：嘗試重新啟動 MariaDB 服務：
bash
```
servbayctl restart mariadb 11.3
```
1

2. 無法連接到 MariaDB

可能原因

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

解決方案

檢查服務狀態：確保 MariaDB 服務正在運行：
bash
```
servbayctl status mariadb 11.3
```
1

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

bash

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

檢查使用者權限：確保使用者有足夠的權限連接到資料庫：
sql
```
SHOW GRANTS FOR 'your_username'@'localhost';
```
1

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

bash

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

3. 性能問題

可能原因

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

解決方案

優化查詢：使用 EXPLAIN 剖析查詢性能，並進行相應優化：
sql
```
EXPLAIN SELECT * FROM your_table_name WHERE column_name = 'value';
```
1

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

[mysqld]
query_cache_size = 64M
innodb_buffer_pool_size = 1G

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

sql

CREATE INDEX idx_column_name ON your_table_name(column_name);

4. 資料庫崩潰

可能原因

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

解決方案

檢查錯誤日誌：查看 MariaDB 錯誤日誌，找到崩潰的具體原因。錯誤日誌路徑為：
bash
```
/Applications/ServBay/logs/mariadb/11.3.err
```
1

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

bash

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

恢復數據：如果資料庫文件損壞，可以從備份中恢復數據。備份文件路徑為：
bash
```
/Applications/ServBay/backup/mariadb/11.3
```
1

5. 備份和恢復問題

可能原因

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

解決方案

檢查備份文件：確保備份文件完整且未損壞。使用以下命令檢查備份文件大小和完整性：
bash
```
ls -lh /Applications/ServBay/backup/mariadb/11.3/your_backup.sql
```
1

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

bash

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

錯誤日誌

bash

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

bash

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，然後按以下詳細步驟操作：

在 my.cnf 中[mysqld]段後添加 innodb_force_recovery = 6
編輯配置文件 my.cnf，找到[mysqld]，添加以下行：
ini
```
innodb_force_recovery = 6
```
1
啟動 MariaDB
使用以下命令啟動 MariaDB：
bash
```
servbayctl start mariadb 11.5
```
1

備份 MariaDB

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

bash

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

禁用 MariaDB 服務
在ServBay的管理面板中，禁用MariaDB 11.5服务
從 my.cnf 中删除 innodb_force_recovery = 6
編輯配置文件 my.cnf，刪除以下行：
ini
```
innodb_force_recovery = 6
```
1

重命名 11.5 目錄

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

bash

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

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

恢復 MariaDB 備份

使用 mysql 命令恢復資料庫：

bash

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

總結

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

MariaDB 服務故障排除指南 ​

常見問題及解決方案 ​

1. MariaDB 服務無法啟動 ​

可能原因 ​

解決方案 ​

2. 無法連接到 MariaDB ​

可能原因 ​

解決方案 ​

3. 性能問題 ​

可能原因 ​

解決方案 ​

4. 資料庫崩潰 ​

可能原因 ​

解決方案 ​

5. 備份和恢復問題 ​

可能原因 ​

解決方案 ​

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

可能原因 ​

錯誤日誌 ​

解決方案 ​

總結 ​

MariaDB 服務故障排除指南

常見問題及解決方案

1. MariaDB 服務無法啟動

可能原因

解決方案

2. 無法連接到 MariaDB

可能原因

解決方案

3. 性能問題

可能原因

解決方案

4. 資料庫崩潰

可能原因

解決方案

5. 備份和恢復問題

可能原因

解決方案

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

可能原因

錯誤日誌

解決方案

總結