Ubuntu MariaDB故障排查步骤有哪些

Ubuntu MariaDB故障排查步骤

1. 检查MariaDB服务状态

首先确认MariaDB服务是否正在运行，使用以下命令查看服务状态：
sudo systemctl status mariadb
若服务未运行，会显示具体错误信息（如“failed”或“inactive”）；若已运行，则跳过后续服务启动步骤。

2. 查看MariaDB错误日志

错误日志是定位故障的关键，Ubuntu下MariaDB的默认错误日志路径为/var/log/mysql/error.log。使用以下命令查看最近50条日志：
sudo tail -n 50 /var/log/mysql/error.log
日志中会明确提示启动失败、连接拒绝或配置错误等具体原因（如“Port 3306 is already in use”或“Access denied for user”）。

3. 验证MariaDB配置文件

MariaDB的主配置文件通常位于/etc/mysql/mariadb.conf.d/50-server.cnf（部分系统可能在/etc/mysql/my.cnf）。重点检查以下配置项：

• bind-address：若需允许远程连接，需将其设置为0.0.0.0（监听所有IP）；若仅本地使用，保持127.0.0.1。
• port：确保端口为3306（默认端口），避免与其他服务冲突。
  修改配置文件后，需重启服务使更改生效：
  sudo systemctl restart mariadb。

4. 检查数据目录与文件权限

MariaDB的数据目录（默认/var/lib/mysql）及其子目录必须属于mysql用户和组，否则会导致启动失败。使用以下命令修复权限：
sudo chown -R mysql:mysql /var/lib/mysql
sudo chmod -R 755 /var/lib/mysql
若数据目录不存在，需手动创建并设置正确权限。

5. 排查端口冲突与防火墙

• 端口冲突：使用netstat或ss命令检查3306端口是否被其他进程占用：
  sudo netstat -tulnp | grep 3306
  若端口被占用，需停止占用进程或修改MariaDB的port配置。
• 防火墙设置：Ubuntu默认使用ufw防火墙，需允许3306端口：
  sudo ufw allow 3306/tcp
sudo ufw reload
  若使用iptables，需添加对应规则：
  sudo iptables -A INPUT -p tcp --dport 3306 -j ACCEPT。

6. 处理启动参数与自动更新问题

• 启动参数问题：若MariaDB启动时卡在进度条或报错，可尝试使用--skip-grant-tables参数跳过权限检查（用于重置密码或修复权限）：
  sudo mysqld_safe --skip-grant-tables &
  启动后无需密码登录，修复问题后再正常重启服务。
• 自动更新问题：系统自动更新可能导致MariaDB配置文件被修改，引发故障。可通过以下命令锁定相关软件包，防止自动更新：
  sudo apt-mark hold mariadb-server mariadb-client mariadb-common。

7. 修复常见特定故障

• 忘记root密码：停止MariaDB服务，以安全模式启动并重置密码：
  sudo systemctl stop mariadb
sudo mysqld_safe --skip-grant-tables &
  登录MariaDB后执行：
  FLUSH PRIVILEGES;
ALTER USER 'root'@'localhost' IDENTIFIED BY 'new_password';
  退出并重启服务：
  sudo systemctl restart mariadb。
• AppArmor权限问题：若AppArmor阻止MariaDB访问文件，可临时禁用AppArmor：
  sudo aa-disable /usr/sbin/mysqld
  或修改AppArmor配置文件（/etc/apparmor.d/usr.sbin.mysqld），添加允许访问的路径，然后重启AppArmor：
  sudo systemctl restart apparmor。

8. 测试连接

完成上述步骤后，测试MariaDB是否可正常连接：

• 本地连接：使用mysql命令登录：
  mysql -u root -p
• 远程连接：从另一台机器使用mysql命令指定服务器IP：
  mysql -h server_ip -u remote_user -p
  输入密码后，若能进入MariaDB shell，则说明连接成功。